How to integrate Habitica MCP with Atomic Agent

Connect Atomic Agent to Habitica MCP. Add a new daily task for exercise, create a challenge for team productivity, and more using natural language, with authentication handled for you.

Habitica logoHabitica
Api Key

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.

70 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Habitica.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Habitica account. See the Atomic Agent documentation for installation instructions.

Also integrate Habitica with

How Atomic Agent connects to Habitica

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Habitica to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Habitica. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Habitica account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Habitica MCP server, and what's possible with it?

The Habitica MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Habitica account. It provides structured and secure access to your tasks, challenges, and groups, so your agent can create tasks, manage challenges, organize groups, and automate productivity routines on your behalf.

  • Automated task creation and management: Let your agent create new tasks, set up habits, or add to-dos to keep your productivity on track—no manual entry needed.
  • Challenge and group organization: Easily create, edit, or delete Habitica challenges and groups so you can coordinate goals and activities with teams or friends.
  • Tag and webhook automation: Have your agent generate new tags for smarter task sorting or set up webhooks for real-time notifications when tasks change or are completed.
  • Subscription and group membership management: Direct your agent to check or cancel subscriptions, leave parties, or delete groups as your needs change.
  • Seamless challenge task updates: Effortlessly add or remove tasks within challenges, helping you keep group goals relevant and up to date.

Use Habitica from Atomic Agent

With your account connected, ask Atomic Agent to work with Habitica in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Habitica action and event your agent gets out of the box.

Add Task to Challenge

Tool to add a new task to a specified challenge.

Add Push Device

Tool to register a push notification device for the authenticated user.

Add Tag to Task

Tool to add a tag to a task.

Clone Challenge

Tool to clone an existing challenge.

Create Challenge

Tool to create a new challenge.

Create Habitica Party

Create a new Habitica party for collaborative gameplay.

Create Tag

Tool to create a new tag.

Create Task

Create a new task in Habitica.

Create Webhook

Tool to create a new webhook for taskActivity events.

Delete Habitica Challenge

Permanently delete a Habitica challenge.

Leave or Delete Habitica Group

Leave or delete a Habitica group (party or guild).

Delete Group Chat Message

Tool to delete a chat message from a Habitica group (party, guild, or Tavern).

Delete Habitica Tag

Tool to delete a tag for the authenticated user.

Delete Task

Permanently deletes a user's task (habit, daily, todo, or reward) by its ID.

Delete Task Checklist Item

Tool to delete a checklist item from a task.

Delete User Message

Tool to delete a message from the authenticated user's inbox by its ID.

Delete User Push Device

Tool to remove a push device registration from the authenticated user's account.

Equip Item

Tool to equip or unequip gear, pets, mounts, or costume items in Habitica.

Export Challenge to CSV

Tool to export a Habitica challenge to CSV format.

Get Challenge

Tool to retrieve details of a specific challenge.

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.

Get Challenge Tasks

Tool to get all tasks for a specified challenge.

Get Content

Retrieves all Habitica game content definitions in a single request.

Get Content By Type

Retrieves Habitica game content data filtered by a specific category type.

Get Export History CSV

Tool to export user tasks history in CSV format.

Get Export Inbox HTML

Tool to export inbox data in HTML format from Habitica.

Export User Data JSON

Exports the authenticated user's complete data in JSON format.

Get Group

Retrieves detailed information about a Habitica group (guild or party).

Get Group Members

Retrieve members of a Habitica group (guild or party).

Get Habitica Groups

Retrieves Habitica groups based on type.

Get Habitica Tavern Group

Tool to retrieve the Habitica Tavern (habitrpg) group details.

Get Party Chat Messages

Tool to retrieve party chat messages from Habitica.

Get Model Paths

Retrieves all available field paths and their data types for a specified Habitica model.

Get News

Tool to retrieve the latest Bailey announcement from Habitica.

Get Party

Retrieves the authenticated user's party details from Habitica.

Get Shops Market Gear

Tool to retrieve the available gear for purchase in the market shop.

Get Time Travelers Shop

Tool to retrieve available items in the Time Travelers shop.

Get Habitica API Status

Tool to check Habitica API server status.

Get Tags

Retrieve all tags for the authenticated Habitica user.

Get Tasks

Tool to retrieve all tasks for the authenticated user.

Get User Challenges

Tool to retrieve challenges the authenticated user participates in.

Get User Profile

Retrieves the authenticated user's complete Habitica profile.

Get Webhooks

Retrieves all webhooks configured for the authenticated Habitica user.

Get World State

Retrieves the current state of the Habitica game world including active events, world boss status, and seasonal NPC visual themes.

Invite To Group

Tool to invite users to a specific group.

Invite To Quest

Tool to invite party members to a quest.

Join Challenge

Tool to join a challenge.

Leave Challenge

Tool to leave a Habitica challenge.

Local Login

Tool to authenticate a user via local credentials.

Local User Registration

Tool to register a new Habitica user via email and password.

Mark Group Chat Seen

Tool to mark all chat messages as read/seen for a specific group.

Mark Notification Seen

Tool to mark a single notification as seen in Habitica.

Mark Notifications Seen

Marks specific notifications as read/seen in Habitica.

Move Pinned Item

Tool to move a pinned item in the rewards column to a new position.

Move Task To Position

Move a Habitica task to a new position in the task list.

Dismiss Bailey Announcement

Tool to dismiss the latest Bailey announcement in Habitica, allowing it to be read later.

Reset User Account

Resets the authenticated user's account to starting state.

Read Card

Tool to mark a card as read in Habitica.

Remove Party Member

Removes a member from the authenticated user's party.

Score Task

Score a Habitica task to mark it as completed or incomplete.

Social Auth

Tool to authenticate a user via a social provider.

Subscribe Webhook

Tool to enable (subscribe) an existing webhook by ID for the authenticated user.

Unlink All Challenge Tasks

Tool to unlink all tasks from a Habitica challenge.

Update Group

Tool to update a Habitica group (party or guild) by modifying its properties.

Update Tag

Tool to update an existing tag's name.

Update Task

Update an existing task in Habitica.

Update Task Checklist Item

Tool to update a checklist item in a task.

Update User

Update the authenticated user's profile, preferences, flags, and other settings in Habitica.

Validate Coupon Code

Validate a Habitica coupon code to check if it is valid and active.

FAQ

Frequently asked questions

With a standalone Habitica MCP server, the agents and LLMs can only access a fixed set of Habitica tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Habitica and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Habitica tools.

Yes, absolutely. You can configure which Habitica scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Habitica data and credentials are handled as safely as possible.

Start with Habitica.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Habitica tool your agent needs.Free to start.

Start building