habitca-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HABITICA_APP_ID | No | Optional app identifier sent as x-client header for Habitica analytics. | |
| HABITICA_USER_ID | Yes | Your Habitica User ID from API settings. | |
| HABITICA_API_TOKEN | Yes | Your Habitica API Token from API settings. |
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_profileA | Get the authenticated user's full profile (stats, prefs, items, party, etc). |
| get_statsA | Get user stats only (HP, MP, XP, level, gold, class). |
| get_tasksC | List tasks. Optionally filter by type. |
| get_taskC | Get a single task by id. |
| create_taskB | Create a habit, daily, todo, or reward. |
| update_taskC | Update fields on a task (text, notes, difficulty, priority, etc). |
| score_taskA | Score a task. direction='up' completes a todo/daily or marks a + habit; 'down' is for negative habits. |
| delete_taskC | Delete a task by id. |
| get_task_checklistC | Get checklist items for a task. |
| add_checklist_itemC | Add a checklist item to a task. |
| update_checklist_itemB | Update text/completed on a checklist item. |
| score_checklist_itemC | Toggle a checklist item complete/incomplete. |
| delete_checklist_itemC | Delete a checklist item. |
| get_tagsA | Get all tags. |
| create_tagD | Create a tag. |
| get_inventoryA | Get full inventory (items, eggs, food, hatching potions, special). |
| get_petsA | Get owned pets map. |
| get_mountsA | Get owned mounts map. |
| feed_petB | Feed a pet a piece of food. |
| hatch_petC | Hatch a pet from an egg + hatching potion. |
| equip_itemC | Equip a pet, mount, costume piece, or battle gear. |
| buy_rewardC | Buy a custom reward by key. |
| get_shopB | Get items in a shop (default: market). |
| buy_itemC | Buy an item from a shop. |
| cast_spellB | Cast a class spell, optionally on a target task or party member. |
| get_notificationsC | Get unread notifications. |
| read_notificationC | Mark a notification as read. |
| run_cronA | Run the daily cron (advance day, apply damage from missed dailies). Normally auto-runs on first action of the day. |
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 28 tools
Most tools have clearly distinct purposes (e.g., get_task vs get_tasks, buy_item vs buy_reward). A few overlaps exist (get_inventory and get_user_profile both return items) but descriptions reduce ambiguity.
All tool names follow a consistent verb_noun snake_case pattern (e.g., create_task, buy_item, equip_item). No mixing of conventions or chaotic naming.
28 tools cover a broad gamification system (tasks, inventory, pets, spells, shop). Slightly high but justified by the feature set; not excessive.
Core task and checklist operations are complete, but missing CRUD for tags (no delete/update), rewards management beyond buying, and some inventory actions. Notable gaps exist.