Habitica MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_LANG | No | Language setting for the server, e.g., 'en' or 'zh-CN'. | en |
| HABITICA_USER_ID | Yes | Your Habitica User ID, found in Settings -> API. | |
| HABITICA_API_TOKEN | Yes | Your Habitica API Token, found in Settings -> API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_user_profileC | Get user profile |
| get_tasksC | Get tasks list |
| create_taskD | Create new task |
| score_taskC | Score task / habit |
| update_taskD | Update task |
| delete_taskD | Delete task |
| get_statsC | Get user stats |
| buy_rewardD | Buy reward |
| get_inventoryD | Get inventory |
| cast_spellD | Cast spell |
| get_tagsC | Get tags list |
| create_tagC | Create tag |
| get_petsC | 获取宠物列表 |
| feed_petC | 喂养宠物 |
| hatch_petC | 孵化宠物 |
| get_mountsC | 获取坐骑列表 |
| equip_itemD | 装备物品 |
| get_notificationsC | 获取通知列表 |
| read_notificationC | 标记通知为已读 |
| get_shopC | 获取商店物品 |
| buy_itemC | 购买商店物品 |
| add_checklist_itemC | Add checklist item to task |
| update_checklist_itemD | Update checklist item |
| delete_checklist_itemD | Delete checklist item |
| get_task_checklistC | Get task checklist items |
| score_checklist_itemC | Score checklist item (mark complete/incomplete) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 26 tools
Most tools have distinct purposes targeting specific Habitica resources like tasks, checklist items, pets, mounts, inventory, and user data. However, some potential overlap exists between 'score_task' and 'score_checklist_item' as both involve scoring/marking items, though they target different resource levels. Overall, the descriptions clearly differentiate the tools.
The naming follows a mostly consistent verb_noun pattern (e.g., create_task, delete_task, get_tasks), but there is inconsistency in language with some tools in Chinese (e.g., '购买商店物品' for buy_item, '装备物品' for equip_item) and others in English. This mixed language usage reduces predictability and readability, though the verb_noun structure is generally maintained.
With 26 tools, the count is on the higher side for an MCP server, bordering on heavy. While Habitica is a feature-rich platform with tasks, pets, mounts, inventory, and user management, the tool set might be slightly over-scoped, potentially leading to complexity for agents. It's not extreme, but it feels borderline for efficient use.
The tool set provides comprehensive coverage of Habitica's core domain, including full CRUD operations for tasks and checklist items, user profile and stats management, inventory and shop interactions, pet and mount handling, and notification management. There are no obvious gaps; agents can perform typical workflows like task creation, scoring, and resource management without dead ends.