How to connect Habitica to Claude Cowork

Trusted by teams atAWSGleanZoomAirtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Habitica logo
Claude Cowork logo
divider

Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.

This guide walks you through the easiest and most secure way to connect your Habitica account to Cowork 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.

Also integrate Habitica with

Connecting Habitica to Claude Cowork

1. Open Customize

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

2. Add the Composio MCP server

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

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

4. Connect your Habitica account

Back in Cowork, ask the agent to connect to Habitica or give it any Habitica-related task.

For example, ask Cowork 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 Cowork, and your Habitica account is ready to use.

What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.

With Composio Connect, Cowork can securely access apps like Habitica through MCP without you sharing account credentials directly with the agent.

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.

Supported Tools & Triggers

Tools
Add Task to ChallengeTool to add a new task to a specified challenge.
Cancel SubscriptionAttempts to cancel the authenticated user's subscription.
Create ChallengeTool to create a new challenge.
Create Habitica GroupTool to create a Habitica party or guild.
Create TagTool to create a new tag.
Create TaskTool to create a new user task in Habitica.
Create WebhookTool to create a new webhook for taskActivity events.
Delete a Habitica ChallengeTool to delete a challenge.
Delete Challenge TaskTool to delete a specific task from a challenge.
Delete Habitica GroupTool to delete a Habitica group (guild) or leave a party.
Delete Habitica TagTool to delete a tag for the authenticated user.
Delete TaskTool to delete a Habitica task.
Get Habitica AchievementsTool to retrieve all available Habitica achievements.
Get ChallengeTool to retrieve details of a specific challenge.
Get Group ChallengesTool to retrieve challenges available in a specific group (guild, party, or tavern).
Get Challenge TaskTool to retrieve a specific task from any challenge.
Get Challenge TasksTool to get all tasks for a specified challenge.
Get ContentTool to retrieve global game content definitions.
Get Content By TypeTool to retrieve game content for a specified category.
Get EquipmentTool to retrieve the authenticated user’s equipped gear and costume.
Get GroupTool to retrieve details of a specific group.
Get Group MembersTool to retrieve members of a specific group.
Get Habitica GroupsTool to retrieve Habitica groups (guilds, parties, taverns).
Get NotificationsTool to retrieve notifications for the authenticated user.
Get PartyTool to retrieve the authenticated user's party details.
Get Party MembersTool to retrieve members of the authenticated user's party.
Get TagsTool to retrieve authenticated user's tags.
Get TasksTool to retrieve all tasks for the authenticated user.
Get User AchievementsTool to retrieve the authenticated user's achievements.
Get User ChallengesTool to retrieve challenges the authenticated user participates in.
Get User InventoryTool to retrieve the authenticated user's full inventory.
Get User ProfileTool to retrieve the authenticated user's profile information.
Get User Quest ProgressTool to retrieve the authenticated user's quest progress.
Get User StatsTool to retrieve the authenticated user's Habitica statistics.
Get User SubscriptionTool to retrieve the authenticated user's subscription details.
Get WebhooksTool to retrieve webhooks for the authenticated user.
Invite To GroupTool to invite users to a specific group.
Invite To PartyTool to invite users to the authenticated user's party.
Join ChallengeTool to join a challenge.
Leave ChallengeTool to leave a Habitica challenge.
Local LoginTool to authenticate a user via local credentials.
Local User RegistrationTool to register a new Habitica user via email and password.
Mark Notifications SeenTool to mark specific notifications as read.
Remove Party MemberTool to remove a member from your party.
Score TaskTool to score (check/uncheck) a Habitica task.
Social AuthTool to authenticate a user via a social provider.
Subscribe WebhookTool to enable (subscribe) an existing webhook by ID for the authenticated user.

How to build Habitica MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Habitica MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Habitica MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Habitica MCP with Claude Code

Codex logo

Codex

Use Habitica MCP with Codex

OpenClaw logo

OpenClaw

Use Habitica MCP with OpenClaw

Hermes logo

Hermes

Use Habitica MCP with Hermes

CLI logo

CLI

Use Habitica MCP with CLI

Google ADK logo

Google ADK

Use Habitica MCP with Google ADK

LangChain logo

LangChain

Use Habitica MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Habitica MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Habitica MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Habitica MCP with LlamaIndex

CrewAI logo

CrewAI

Use Habitica MCP with CrewAI

FAQ

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

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.

Can I use Tool Router MCP with Claude Cowork?

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.

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

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.

How safe is my data with Composio Tool Router?

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.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗