Habitica

Retrieves Habitica groups based on type. Use 'guilds' to get all guilds the authenticated user belongs to, 'party' to get the user's current party, or 'tavern' to get the global Tavern (the main public chat).

Untrusted display-only summary

Tool to retrieve the Habitica Tavern (habitrpg) group details. The Tavern is the main public group where all Habitica users can chat and participate in community discussions.

Untrusted display-only summary

Tool to retrieve party chat messages from Habitica. Use when you need to fetch recent chat messages from the authenticated user's party.

Untrusted display-only summary

Retrieves all available field paths and their data types for a specified Habitica model. Use this to discover the structure and available fields for user, group, challenge, tag, or task models. Helpful for understanding what fields can be queried or updated.

Untrusted display-only summary

Tool to retrieve the latest Bailey announcement from Habitica. Use when you need to check current news, events, or updates posted by Bailey.

Untrusted display-only summary

Retrieves the authenticated user's party details from Habitica. Returns information about the user's current party including: - Party name, description, and member count - Party leader information - Current quest status and progress - Recent chat messages - Leader-only permissions Note: Returns an error if the user is…

Untrusted display-only summary

Tool to retrieve the available gear for purchase in the market shop. Use when you need to check what equipment is available for each character class. Returns gear organized by class: healer, wizard, rogue, and warrior.

Untrusted display-only summary

Tool to retrieve available items in the Time Travelers shop. Use when you need to see what quests, backgrounds, pets, or mounts can be purchased with hourglasses.

Untrusted display-only summary

Tool to check Habitica API server status. Use when you need to verify if the Habitica service is operational before making other API calls.

Untrusted display-only summary

Retrieve all tags for the authenticated Habitica user. Tags are labels that can be attached to tasks for organization. Returns both user-created tags and challenge-related tags. Use this to get tag IDs for filtering tasks or assigning tags to new tasks.

Untrusted display-only summary

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

Untrusted display-only summary

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

Untrusted display-only summary

Retrieves the authenticated user's complete Habitica profile. Returns comprehensive user data including: - Stats: HP, MP, level, experience, gold, and character class - Inventory: gear, pets, mounts, eggs, potions, and quest items - Achievements: unlocked achievements and completed quests - Party: current party member…

Untrusted display-only summary

Retrieves all webhooks configured for the authenticated Habitica user. Returns a list of webhooks including their URLs, types, enabled status, and task activity options. Use this to check existing webhook configurations, monitor webhook health via failure counts, or get webhook IDs for updates/deletions.

Untrusted display-only summary

Retrieves the current state of the Habitica game world including active events, world boss status, and seasonal NPC visual themes. Use when checking for active world events, monitoring world boss progress, or determining current seasonal themes.

Untrusted display-only summary

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

Untrusted display-only summary

Tool to invite party members to a quest. Use when you want to start a quest with a specific quest key in a group. The user must own the quest scroll to invite others.

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

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

Untrusted display-only summary

Tool to mark all chat messages as read/seen for a specific group. Use when you need to clear unread message notifications in a group chat. Requires a valid group ID ('party' for user's party, 'habitrpg' for Tavern).

Untrusted display-only summary

Tool to mark a single notification as seen in Habitica. Use this when you need to mark one specific notification as read after the user has viewed it.

Untrusted display-only summary

Marks specific notifications as read/seen in Habitica. Use this after getting notifications to clear unread notification badges. Requires valid notification IDs from the Get Notifications action. Returns updated notification state.

Untrusted display-only summary

Tool to move a pinned item in the rewards column to a new position. Use when you need to reorder pinned items after sorting them.

Untrusted display-only summary

Move a Habitica task to a new position in the task list. Use this when you need to reorder tasks by moving a specific task to the top (position=0), bottom (position=-1), or any specific position. The response returns the updated task order for the task type (habit, daily, todo, or reward) that the moved task belongs t…

Untrusted display-only summary

Tool to dismiss the latest Bailey announcement in Habitica, allowing it to be read later. Use this when the user wants to clear the current news notification without reading it. The announcement will reappear later.

Untrusted display-only summary

Resets the authenticated user's account to starting state. This permanently deletes all tasks, resets character to level 1, and clears progress while retaining some items and achievements. Use with caution as this action is irreversible.

Untrusted display-only summary

Tool to mark a card as read in Habitica. Use when a user receives a special card (birthday, greeting, nye, thankyou, or valentine) and wants to acknowledge it. Updates user.flags.cardReceived and returns updated user.items.special.

Untrusted display-only summary

Removes a member from the authenticated user's party. Requirements: - You must be the party leader to remove members - You cannot remove yourself (use Leave Party instead) - The member must be currently in your party Use Get Party Members first to obtain member IDs. This action is typically used to remove inactive mem…

Untrusted display-only summary