Habitica

Habitica is an open-source task management application that gamifies productivity by turning tasks into role-playing game elements.

VIEWS

USERS

2104

VERSION

0.1.0(Updated 12h ago)

85VIEWS

2104USERS

Install MCP Server

Paste and run this command in your terminal to set up Cursor with MCP

npx @composio/cli add cursor --app habiticanpx @composio/cli add cursor --app habiticanpx @composio/cli add cursor --app habiticanpx @composio/cli add cursor --app habiticanpx @composio/cli add cursor --app habitica

After running the command, restart Cursor to start using the MCP Server.

View Docs

Available Tools

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.

Cancel Subscription

Attempts to cancel the authenticated user's subscription. Since Habitica's public API does not provide a cancellation endpoint, this action checks the current subscription state and returns: - success=True with a no-op message if there is no active subscription - success=False with guidance to cancel via the website/app if a subscription appears active

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 Group

Tool to create a Habitica party or guild. Use when you want to initialize a new group with name, type, and optional privacy and description.

Create Tag

Tool to create a new tag. Use after determining the desired tag name.

Create Task

Tool to create a new user task in Habitica. Use after gathering task details like text, type, and optional properties.

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 A Habitica Challenge

Tool to delete a challenge. Use when you need to permanently remove a challenge after confirmation.

Delete Challenge Task

Tool to delete a specific task from a challenge. Use when removing an unwanted or outdated task from a challenge. Use after confirming the task belongs to the target challenge.

Delete Habitica Group

Tool to delete a Habitica group (guild) or leave a party. - For parties: Habitica does not support deleting via DELETE /groups/{id}. The correct flow is to leave the party via POST /groups/party/leave. - For guilds: If you are the leader and there are no members, you can delete the guild via DELETE /groups/{id}. Otherwise, you may need to manage membership first.

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

Tool to delete a Habitica task. Use when you have the task ID and want to remove it permanently.

Get Habitica Achievements

Tool to retrieve all available Habitica achievements. Use after authenticating to list achievements and their progress.

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 Challenge Task

Tool to retrieve a specific task from any challenge. Use after you have the task ID and need its full details.

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

Tool to retrieve global game content definitions. Use when loading Habitica items, equipment, pets, quests, and other definitions. Call once per session to cache content.

Get Content By Type

Tool to retrieve game content for a specified category. Use when you need to fetch specific Habitica content by its type (e.g., items, quests). Use after identifying the content type.

Get Equipment

Tool to retrieve the authenticated user’s equipped gear and costume. Use when you need to inspect current battle gear and costume slots.

20 actions available