Connect Habitica to OpenClaw on Operator.io
Habitica is an open-source task manager that gamifies your to-do lists and daily habits. Level up your productivity by turning tasks into an engaging RPG experience.
Automate Habitica with AI
Your OpenClaw agent lives on Operator and treats Habitica as one more service it can drive. Send it an outcome in a Telegram or Discord message and it works out which of the 70 Habitica actions to run, then runs them.
Your agent reaches Habitica directly or through connectors like Composio MCP and Pipedream MCP, which handle the sign in and token refresh for you, so there is nothing to wire up and no API keys to paste.
What your agent can do with Habitica
Your agent can call any of these Habitica actions by name as part of a larger task. Ask for the outcome you want and it picks the right ones.
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.
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.
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.
Clone Challenge
Tool to clone an existing challenge. Use when you need to duplicate a challenge to a different group with a new name.
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 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...
Create Tag
Tool to create a new tag. Use after determining the desired tag name.
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...
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 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...
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...
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.
Delete Habitica 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
Permanently 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.
Delete Task Checklist Item
Tool to delete a checklist item from a task. Use when you need to remove a specific checklist item from a todo or daily task.
Delete User Message
Tool to delete a message from the authenticated user's inbox by its ID. Use when you need to remove a specific message from the user's Habitica inbox.
Delete User Push Device
Tool to remove a push device registration from the authenticated user's account. Use when you need to unregister a device that should no longer receive push notifications.
Equip Item
Tool 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.
Export Challenge to CSV
Tool to export a Habitica challenge to CSV format. Use when you need to download challenge data as a CSV file. The CSV contains all challenge tasks and participant information.
Get Challenge
Tool to retrieve details of a specific challenge. Use when you have the challenge ID and need its full data.
Get Group Challenges
Tool to retrieve challenges available in a specific group (guild, party, or tavern).
Get Task by ID
Retrieve 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 st...
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
Retrieves all Habitica game content definitions in a single request. Returns ~9MB of static game data including achievements, quests, gear, pets, mounts, eggs, hatching potions, food, backgrounds, spells, and more. Use cases: - Loading f...
Get Content By Type
Retrieves Habitica game content data filtered by a specific category type. Use this tool to fetch game definitions like quest details, equipment stats, pet/mount info, backgrounds, spells, or other static game content. Useful when you ne...
Get Export History CSV
Tool to export user tasks history in CSV format. Returns CSV data with task completions and updates over time.
Get Export Inbox HTML
Tool to export inbox data in HTML format from Habitica. Use when you need to retrieve the user's private messages and inbox content as an HTML document.
Export User Data JSON
Exports the authenticated user's complete data in JSON format. Use when you need a full backup or comprehensive snapshot of all user data. Returns the raw internal data structure with all fields and nested objects.
Get Group
Retrieves 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.
Get Group Members
Retrieve 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.
Get Habitica Groups
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).
Get Habitica Tavern Group
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.
Get Party Chat Messages
Tool to retrieve party chat messages from Habitica. Use when you need to fetch recent chat messages from the authenticated user's party.
Get Model Paths
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 b...
Get News
Tool to retrieve the latest Bailey announcement from Habitica. Use when you need to check current news, events, or updates posted by Bailey.
Get Party
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 - Re...
Get Shops Market Gear
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.
Get Time Travelers Shop
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.
Get Habitica API Status
Tool to check Habitica API server status. Use when you need to verify if the Habitica service is operational before making other API calls.
Get Tags
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 ta...
Get Tasks
Tool to retrieve all tasks for the authenticated user. Use when you need the user's current tasks list after authenticating.
Get User Challenges
Tool to retrieve challenges the authenticated user participates in. Use when you need a paginated list of user challenges.
Get User Profile
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 - Achi...
Get Webhooks
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...
Get World State
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...
Invite To Group
Tool to invite users to a specific group. Use when you need to send invitations by user UUID, email, or username.
Invite To Quest
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.
Join Challenge
Tool to join a challenge. Use after confirming the challenge ID to participate in a specific challenge.
Plus 22 more Habitica actions your agent can call.
How to connect Habitica
You authorize Habitica once from your dashboard. Operator holds the connection and refreshes the access tokens on its own, so your agent keeps working with Habitica without you signing in again. The same setup unlocks every other app your agent can reach, so you only do it once.
When you are ready, the get started guide walks through standing up your OpenClaw agent.
Common questions about Habitica
- How do I connect Habitica to Operator?
- You authorize Habitica once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Habitica without you signing in again.
- Can my agent manage tasks and projects in Habitica?
- Yes. It can create and update items, move them between stages, add notes, and read the current state back to you. Use it to file new work as it arrives, check status without opening the app, or keep Habitica aligned with what is happening elsewhere.
- Do I need to write code or manage Habitica API keys?
- No code and no API keys. You authorize Habitica through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.
- Can my agent use Habitica together with my other apps?
- Yes. The same agent reaches every app you connect, so it can move between Habitica and tools like Google Sheets, Notion, Linear in one job, reading from one and acting in another without you wiring anything between them.
More apps to automate
Apps your agent runs alongside Habitica, or browse all integrations.
Put your agent on Habitica
Sign in, connect Habitica, and hand your agent the work. Your first week is free.
Try for free