# Habitica AI integration on Definable

> Habitica is an open-source task management application that gamifies productivity by turning tasks into role-playing game elements.

## What this connects

Habitica is an open-source task management application that gamifies productivity by turning tasks into role-playing game elements.

Vendor: https://habitica.com/

## Tools available

**70** tools available. First 12:

- `HABITICA_ADD_CHALLENGE_TASK` — Add Task to Challenge — Tool to add a new task to a specified challenge. Use when you need to programmatically create a challenge task after the challenge is set up and you have its ID.
- `HABITICA_ADD_PUSH_DEVICE` — Add Push Device — Tool to register a push notification device for the authenticated user. Use when you need to enable push notifications for mobile devices or UnifiedPush clients.
- `HABITICA_ADD_TAG_TO_TASK` — Add Tag to Task — Tool to add a tag to a task. Use when you need to categorize or label a task with an existing tag.
- `HABITICA_CLONE_CHALLENGE` — Clone Challenge — Tool to clone an existing challenge. Use when you need to duplicate a challenge to a different group with a new name.
- `HABITICA_CREATE_CHALLENGE` — Create Challenge — Tool to create a new challenge. Use when you need to start a challenge in a specific group with title, summary, and optional tasks.
- `HABITICA_CREATE_GROUP` — Create Habitica Party — Create a new Habitica party for collaborative gameplay. Use this tool to create a party where users can: - Participate in quests together - Chat with party members - Share achievements and progress **Important Notes:** - A user can only be in one party at a time. If already in a party, they must leave first. - Guilds are no longer supported by Habitica (removed August 2023). Only 'party' type works. - The authenticated user automatically becomes the party leader.
- `HABITICA_CREATE_TAG` — Create Tag — Tool to create a new tag. Use after determining the desired tag name.
- `HABITICA_CREATE_TASK` — Create Task — Create a new task in Habitica. Supports four task types: - 'habit': Recurring positive/negative actions (use up/down to enable +/- buttons) - 'daily': Scheduled tasks that repeat on a schedule (configure with frequency, repeat, startDate) - 'todo': One-time tasks with optional due date (use date field) - 'reward': Custom rewards that cost gold (set value for the gold cost) Required fields: text (task title), type (habit/daily/todo/reward). Optional: notes, priority (0.1=Trivial, 1=Easy, 1.5=Medium, 2=Hard), tags, checklist.
- `HABITICA_CREATE_WEBHOOK` — Create Webhook — Tool to create a new webhook for taskActivity events. Use when you need real-time notifications of task creation, updates, deletion, or scoring.
- `HABITICA_DELETE_CHALLENGE` — Delete Habitica Challenge — Permanently delete a Habitica challenge. Only the challenge leader (creator) or an admin can delete a challenge. This action is irreversible - once deleted, the challenge and all associated tasks are permanently removed. Use HABITICA_GET_USER_CHALLENGES to find challenge IDs you own.
- `HABITICA_DELETE_GROUP` — Leave or Delete Habitica Group — Leave or delete a Habitica group (party or guild). This tool allows you to: 1. Leave a party: Pass 'party' as groupId or the party's UUID to leave your current party. 2. Leave a guild: Pass the guild's UUID to leave the guild. 3. Delete a guild: If you are the leader and there are no other members, passing the guild's UUID will delete it (DELETE endpoint is tried if leave fails). Note: The Habitica API endpoint used is POST /groups/:groupId/leave. Only if that fails (e.g., you're the leader trying to delete an empty guild), the DELETE /groups/:groupId endpoint is attempted.
- `HABITICA_DELETE_GROUP_CHAT_MESSAGE` — Delete Group Chat Message — Tool to delete a chat message from a Habitica group (party, guild, or Tavern). Use when you need to remove a specific chat message. Note that only the message author or group moderators can delete messages.

## Auth

Auth schemes: `API_KEY`.

## How agents use Habitica

Inside a Definable workflow, Habitica is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Habitica** — the Researcher (GPT-5.5) pulls context from Habitica (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Habitica** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Habitica (create record, post message, draft email).
- **Designer / Engineer → Distributor → Habitica** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Habitica (attach file, open PR comment, post status).

The Verifier checks every Habitica call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- productivity — https://definable.ai/apps/category/productivity/
- task management — https://definable.ai/apps/category/task-management/
- gaming — https://definable.ai/apps/category/gaming/

## Related

- HTML page: https://definable.ai/apps/habitica/
- Same category (productivity): https://definable.ai/apps/category/productivity/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt