Habitica

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.

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

Tool to create a new challenge. Use when you need to start a challenge in a specific group with title, summary, and optional tasks.

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.

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

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

Tool to create a new webhook for taskActivity events. Use when you need real-time notifications of task creation, updates, deletion, or scoring.

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

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.

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.

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.

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

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

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

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

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

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.

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.

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.

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

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

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

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

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

Tool to retrieve the authenticated user's party details. Use when you need to fetch the current party information after authenticating.

Tool to retrieve members of the authenticated user's party. Use after authenticating to list current party members.

Tool to retrieve authenticated user's tags. Use when you need to list the authenticated user's tags after confirming credentials.

Tool to retrieve all tasks for the authenticated user. Use when you need the user's current tasks list after authenticating.

Tool to retrieve the authenticated user's achievements. Use after authenticating to fetch the current user's achievements.

Tool to retrieve challenges the authenticated user participates in. Use when you need a paginated list of user challenges.

Tool to retrieve the authenticated user's full inventory. Use after authentication to list all owned items.

Tool to retrieve the authenticated user's profile information. Use after authenticating to fetch user details.

Tool to retrieve the authenticated user's quest progress. Use after authenticating to fetch the current user's quest progress.

Tool to retrieve the authenticated user's Habitica statistics. Use after authentication to fetch user's stats block.

Tool to retrieve the authenticated user's subscription details. Use after authenticating to verify current subscription status.

Tool to retrieve webhooks for the authenticated user. Use when you need to list the user's webhooks after authenticating.

Tool to invite users to a specific group. Use when you need to send invitations by user UUID, email, or username.

Tool to invite users to the authenticated user's party. Use when you have a list of identifiers (UUIDs, emails, or usernames) ready and want to add them to your current party.

Tool to join a challenge. Use after confirming the challenge ID to participate in a specific challenge.

Tool to leave a Habitica challenge. Use when you need to remove yourself from a specific challenge and decide whether to keep or remove its tasks.

Tool to authenticate a user via local credentials. Use when needing an API token for subsequent Habitica requests.

Tool to register a new Habitica user via email and password. Use when creating a fresh account before authentication.

Tool to mark specific notifications as read. Use when you want to clear unread notification badges after reviewing your notifications.

Tool to remove a member from your party. Use when you need to eject a user from your party as the party leader.

Tool to score (check/uncheck) a Habitica task. Use when you need to mark a task as completed or undone.

Tool to authenticate a user via a social provider. Use after obtaining an OAuth token or code from Facebook, Google, GitHub, or Apple.

Tool to enable (subscribe) an existing webhook by ID for the authenticated user. This aligns with Habitica's documented API by updating the webhook resource to ensure it is enabled. Usage: obtain the webhook ID (e.g., via Get Webhooks or after creating a webhook) and call this action to set enabled=true.