Habitica integration

Get achievements

Tool to retrieve all available Habitica achievements. Use after authenticating to list achievements and their progress.

Get challenge

Tool to retrieve details of a specific challenge. Use when you have the challenge ID and need its full data.

Get challenges

Tool to retrieve challenges available in a specific group (guild, party, or tavern).

Get challenge task

Tool to retrieve a specific task from any challenge. Use after you have the task ID and need its full details.

Get challenge tasks

Tool to get all tasks for a specified challenge. Use when you have a challenge ID and need to list its defined tasks, including challenge metadata per task.

Get content

Tool to retrieve global game content definitions. Use when loading Habitica items, equipment, pets, quests, and other definitions. Call once per session to cache content.

Get content by type

Tool to retrieve game content for a specified category. Use when you need to fetch specific Habitica content by its type (e.g., items, quests). Use after identifying the content type.

Get equipment

Tool to retrieve the authenticated user’s equipped gear and costume. Use when you need to inspect current battle gear and costume slots.

Get group

Tool to retrieve details of a specific group. Use when you have a groupId and need its metadata.

Get group members

Tool to retrieve members of a specific group. Use when you have a groupId and need its member list.

Get groups

Tool to retrieve Habitica groups (guilds, parties, taverns). Use when browsing or searching available groups by type or name before joining.

Get notifications

Tool to retrieve notifications for the authenticated user. Use when you need to fetch the user's current notification list after authenticating.

Add challenge task

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.

Cancel subscription

Attempts to cancel the authenticated user's subscription. Since Habitica's public API does not provide a cancellation endpoint, this action checks the current subscription state and returns: - success=True with a no-op message if there is no active subscription - success=False with guidance to cancel via the website/app if a subscription appears active

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.

Create group

Tool to create a Habitica party or guild. Use when you want to initialize a new group with name, type, and optional privacy and description.

Create tag

Tool to create a new tag. Use after determining the desired tag name.

Create task

Tool to create a new user task in Habitica. Use after gathering task details like text, type, and optional properties.

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.

Delete challenge

Tool to delete a challenge. Use when you need to permanently remove a challenge after confirmation.

Delete challenge task

Tool to delete a specific task from a challenge. Use when removing an unwanted or outdated task from a challenge. Use after confirming the task belongs to the target challenge.

Delete group

Tool to delete a Habitica group (guild) or leave a party. - For parties: Habitica does not support deleting via DELETE /groups/{id}. The correct flow is to leave the party via POST /groups/party/leave. - For guilds: If you are the leader and there are no members, you can delete the guild via DELETE /groups/{id}. Otherwise, you may need to manage membership first.

Delete tag

Tool to delete a tag for the authenticated user. Use when you need to remove an obsolete tag after confirming it’s no longer applied to any tasks.

Delete task

Tool to delete a Habitica task. Use when you have the task ID and want to remove it permanently.