How to connect Habitica to Claude

Connect Claude Web, Desktop and Cowork 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.

Get started for free Get a demo

Habitica

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

Managed auth

Connect Habitica without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Habitica account to Claude via Composio Connect, enabling it to add a new daily task for exercise, create a challenge for team productivity, delete an outdated task from your challenge, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Habitica with

Claude Code OpenAI Agents SDK Claude Agent SDK Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Habitica to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Habitica account

Back in Claude, ask it to connect to Habitica or give it any Habitica-related task.

For example, ask Claude to:

"Add a new daily task for exercise"
"Create a challenge for team productivity"
"Delete an outdated task from your challenge"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Habitica account is ready to use.

What is the Habitica Claude Connector, 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.

Troubleshooting

1. Why does Claude not use the Composio connector for Habitica?

The connector can show as connected, but Claude must use it in each Habitica conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Habitica again.

2. Why does Claude show an MCP server error before Habitica connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Habitica.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Habitica.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Habitica authorization link not work?

The Composio connector is one server. Your Habitica account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Habitica connection.
Composio creates a fresh Habitica authorization link.
Open that link in your browser and finish the Habitica sign-in.

4. Why do Habitica actions fail after they worked before?

The Habitica connection can expire or lose permission.

Ask Claude to inspect the Habitica connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Habitica account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Habitica.
If the action still fails with a permission error, check that the connected account has that permission in Habitica itself.

5. How do I switch to a different Habitica account?

Claude can manage the Habitica connection for you.

Ask Claude to disconnect or delete the current Habitica account.
Ask Claude to connect Habitica again.
Open the new Composio authorization link for Habitica.
Sign in with the other Habitica account in the browser.
After the account connects, ask Claude to retry the Habitica task.

6. Why is my Habitica connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Habitica connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Habitica tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Habitica.

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.

FRAMEWORKS

How to build Habitica MCP Agent with another framework

Claude Code

Use Habitica MCP with Claude Code

OpenAI Agents SDK

Use Habitica MCP with OpenAI Agents SDK

Claude Agent SDK

Use Habitica MCP with Claude Agent SDK

Codex

Use Habitica MCP with Codex

OpenClaw

Use Habitica MCP with OpenClaw

Hermes

Use Habitica MCP with Hermes

Atomic Agent

Use Habitica MCP with Atomic Agent

Google ADK

Use Habitica MCP with Google ADK

LangChain

Use Habitica MCP with LangChain

Vercel AI SDK

Use Habitica MCP with Vercel AI SDK

Mastra AI

Use Habitica MCP with Mastra AI

LlamaIndex

Use Habitica MCP with LlamaIndex

CrewAI

Use Habitica MCP with CrewAI

Pydantic AI

Use Habitica MCP with Pydantic AI

AutoGen

Use Habitica MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

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. Claude Cowork 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

How to connect Habitica to Claude

Connect Habitica without auth hassles

Introduction

Also integrate Habitica with

Connecting Habitica to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Habitica account

What is the Habitica Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Habitica?

2. Why does Claude show an MCP server error before Habitica connects?

3. Why does the Habitica authorization link not work?

4. Why do Habitica actions fail after they worked before?

5. How do I switch to a different Habitica account?

6. Why is my Habitica connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Habitica MCP Agent with another framework

Claude Code

OpenAI Agents SDK

Claude Agent SDK

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Google Sheets

Notion

Airtable

Asana

Frequently asked questions

What are the differences in Tool Router MCP and Habitica MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Habitica while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Habitica.It takes 30 seconds.