- Category: productivity
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 70
- Triggers: 0
- Slug:
HABITICA - Version: 20261101_00
Tools
Add Task to Challenge
Add Task to Challenge
HABITICA_ADD_CHALLENGE_TASKTool 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.Input Parameters
Output
Add Push Device
Add Push Device
HABITICA_ADD_PUSH_DEVICETool to register a push notification device for the authenticated user. Use when you need to enable push notifications for mobile devices or UnifiedPush clients.Input Parameters
Output
Add Tag to Task
Add Tag to Task
HABITICA_ADD_TAG_TO_TASKTool to add a tag to a task. Use when you need to categorize or label a task with an existing tag.Input Parameters
Output
Clone Challenge
Clone Challenge
Create Challenge
Create Challenge
Create Habitica Party
Create Habitica Party
HABITICA_CREATE_GROUPCreate 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.Input Parameters
Output
Create Tag
Create Tag
Create Task
Create Task
HABITICA_CREATE_TASKCreate 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.Input Parameters
Output
Create Webhook
Create Webhook
HABITICA_CREATE_WEBHOOKCreates a Habitica webhook for task activity, group chat, user activity, or quest activity events. Task activity options can select notifications for task creation, updates, deletion, or scoring.Input Parameters
Output
Delete Habitica Challenge
Delete Habitica Challenge
HABITICA_DELETE_CHALLENGEPermanently 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.Input Parameters
Output
Leave or Delete Habitica Group
Leave or Delete Habitica Group
HABITICA_DELETE_GROUPLeave 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.Input Parameters
Output
Delete Group Chat Message
Delete Group Chat Message
HABITICA_DELETE_GROUP_CHAT_MESSAGETool 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.Input Parameters
Output
Delete Habitica Tag
Delete Habitica Tag
Delete Task
Delete Task
HABITICA_DELETE_TASKPermanently deletes a user’s task (habit, daily, todo, or reward) by its ID. The task cannot be recovered after deletion. Use get_tasks to list tasks and their IDs first.Input Parameters
Output
Delete Task Checklist Item
Delete Task Checklist Item
HABITICA_DELETE_TASK_CHECKLIST_ITEMTool to delete a checklist item from a task. Use when you need to remove a specific checklist item from a todo or daily task.Input Parameters
Output
Delete User Message
Delete User Message
Delete User Push Device
Delete User Push Device
Equip Item
Equip Item
HABITICA_EQUIP_ITEMTool to equip or unequip gear, pets, mounts, or costume items in Habitica. Use when you need to change the user’s equipped items. Equipping an already-equipped item will unequip it.Input Parameters
Output
Export Challenge to CSV
Export Challenge to CSV
Get Challenge
Get Challenge
Get Group Challenges
Get Group Challenges
Get Task by ID
Get Task by ID
HABITICA_GET_CHALLENGE_TASKRetrieve a task by its unique ID. Works for any Habitica task type (habit, daily, todo, reward) whether it belongs to a challenge or is a personal user task. Returns full task details including type-specific properties like completion status, streaks, and scheduling information.Input Parameters
Output
Get Challenge Tasks
Get Challenge Tasks
HABITICA_GET_CHALLENGE_TASKSTool 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.Input Parameters
Output
Get Content
Get Content
HABITICA_GET_CONTENTRetrieves Habitica game content definitions in a single request, including achievements, quests, gear, pets, mounts, food, backgrounds, and spells. An optional language can be supplied for localized content.Input Parameters
Output
Get Content By Type
Get Content By Type
HABITICA_GET_CONTENT_BY_TYPERetrieves Habitica game content for a specified category, such as quests, gear, pets, mounts, backgrounds, or spells. It fetches the full content payload and returns the selected top-level category.Input Parameters
Output
Get Export History CSV
Get Export History CSV
Get Export Inbox HTML
Get Export Inbox HTML
Export User Data JSON
Export User Data JSON
Get Group
Get Group
HABITICA_GET_GROUPRetrieves detailed information about a Habitica group (guild or party). Use ‘party’ as groupId to get the user’s current party, or provide a specific group UUID obtained from HABITICA_GET_GROUPS.Input Parameters
Output
Get Group Members
Get Group Members
HABITICA_GET_GROUP_MEMBERSRetrieve members of a Habitica group (guild or party). Supports pagination via lastId parameter and optional search filtering. Use ‘party’ as groupId to get members of the current user’s party.Input Parameters
Output
Get Habitica Groups
Get Habitica Groups
HABITICA_GET_GROUPSRetrieves 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).Input Parameters
Output
Get Habitica Tavern Group
Get Habitica Tavern Group
Get Party Chat Messages
Get Party Chat Messages
Get Model Paths
Get Model Paths
HABITICA_GET_MODELS_MODEL_PATHSRetrieves 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.Input Parameters
Output
Get News
Get News
Get Party
Get Party
HABITICA_GET_PARTYRetrieves 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 not currently in a party. No parameters required - automatically fetches the party for the authenticated user.Output
Get Shops Market Gear
Get Shops Market Gear
Get Time Travelers Shop
Get Time Travelers Shop
Get Habitica API Status
Get Habitica API Status
Get Tasks
Get Tasks
HABITICA_GET_TASKSRetrieve the authenticated user’s Habitica tasks, optionally filtered by task type, including completed to-dos.Input Parameters
Output
Get User Challenges
Get User Challenges
Get User Profile
Get User Profile
Get Webhooks
Get Webhooks
HABITICA_GET_WEBHOOKSRetrieves 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.Output
Get World State
Get World State
Invite To Group
Invite To Group
HABITICA_INVITE_TO_GROUPTool to invite users to a specific group. Use when you need to send invitations by user UUID, email, or username.Input Parameters
Output
Invite To Quest
Invite To Quest
Join Challenge
Join Challenge
HABITICA_JOIN_CHALLENGETool to join a challenge. Use after confirming the challenge ID to participate in a specific challenge.Input Parameters
Output
Leave Challenge
Leave Challenge
HABITICA_LEAVE_CHALLENGETool 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.Input Parameters
keep-all to retain your tasks, remove-all to delete them.Output
Local Login
Local Login
Local User Registration
Local User Registration
Mark Group Chat Seen
Mark Group Chat Seen
HABITICA_MARK_GROUP_CHAT_SEENTool 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).Input Parameters
Output
Mark Notification Seen
Mark Notification Seen
HABITICA_MARK_NOTIFICATION_SEENTool 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.Input Parameters
Output
Mark Notifications Seen
Mark Notifications Seen
HABITICA_MARK_NOTIFICATIONS_SEENMarks specified Habitica notifications as read or seen using their IDs. The response may include updated notifications.Input Parameters
Output
Move Pinned Item
Move Pinned Item
Move Task To Position
Move Task To Position
HABITICA_MOVE_TASK_TO_POSITIONMove 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 to.Input Parameters
Output
Dismiss Bailey Announcement
Dismiss Bailey Announcement
Reset User Account
Reset User Account
Read Card
Read Card
HABITICA_READ_CARDTool 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.Input Parameters
Output
Remove Party Member
Remove Party Member
HABITICA_REMOVE_FROM_PARTYRemoves 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 members or those who no longer wish to participate.Input Parameters
Output
Score Task
Score Task
HABITICA_SCORE_TASKScore a Habitica task to mark it as completed or incomplete. Use this tool to: - Mark a todo as complete (‘up’) or incomplete (‘down’) - Check off a daily task (‘up’) or uncheck it (‘down’) - Record a positive habit action (‘up’) or negative habit action (‘down’) - Redeem a reward (use ‘up’ direction for rewards) Returns updated user stats including health, mana, experience, gold, and level. Scoring tasks can trigger drops (food, eggs, potions) and quest progress.Input Parameters
Output
Subscribe Webhook
Subscribe Webhook
HABITICA_SUBSCRIBE_WEBHOOKTool 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.Input Parameters
Output
Unlink All Challenge Tasks
Unlink All Challenge Tasks
HABITICA_UNLINK_ALL_CHALLENGE_TASKSUnlink all tasks associated with a Habitica challenge, choosing whether to keep or remove them. If no choice is supplied, the request defaults to removing them.Input Parameters
keep-all retains the tasks after unlinking them from the challenge, remove-all removes all tasks after unlinking.Output
Update Group
Update Group
HABITICA_UPDATE_GROUPTool to update a Habitica group (party or guild) by modifying its properties. Use when you need to change the name, description, or summary of an existing group. Only the group leader can update group properties.Input Parameters
Output
Update Tag
Update Tag
Update Task
Update Task
HABITICA_UPDATE_TASKUpdate an existing task in Habitica. Use this to modify task properties like title, notes, priority, or other attributes. Only include fields you want to update - all body parameters are optional.Input Parameters
Output
Update Task Checklist Item
Update Task Checklist Item
HABITICA_UPDATE_TASK_CHECKLIST_ITEMTool to update a checklist item in a task. Use when you need to modify the text of a specific checklist item in a todo or daily task.Input Parameters
Output
Update User
Update User
Validate Coupon Code
Validate Coupon Code
HABITICA_SOCIAL_AUTHTool to authenticate a user via a social provider. Use after obtaining an OAuth token or code from Facebook, Google, GitHub, or Apple.Input Parameters
Output