Habitica Mcp Server

by iBreaker

259 downloads

Not rated

GitHub

Other

About

A Model Context Protocol (MCP) server that lets AI assistants seamlessly interact with the Habitica API – create tasks, track habits, raise pets and enjoy gamified productivity.

Details

Author: iBreaker
Downloads: 259
Categories: Other

- Smart task management – create, view, update, delete all task types
- Habit tracking – record completions and build healthy routines
- Pet raising – hatch and feed pets, watch them grow
- Mount collection – manage and equip various mounts
- Shop & rewards – browse and buy in-game items
- Skill system – cast class skills to enhance gameplay
- User profile – fetch detailed user information and stats
- Tag management – create and manage tags for organisation
- Notification centre – read and manage system notifications
- Inventory – list all owned items and equipment
- Natural-language control – operate Habitica via conversation
- Task suggestions – AI can create tasks on demand
- Progress reporting – automatically track and summarise progress
- Personalised experience – tailored recommendations based on behaviour

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Habitica Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

From the repository

—

`get_user_profile`

Get user profile

`get_tasks`

Get tasks list

`create_task`

Create new task

`score_task`

Score task / habit

`update_task`

Update task

`delete_task`

Delete task

`get_stats`

Get user stats

`buy_reward`

Buy reward

`get_inventory`

Get inventory

`cast_spell`

Cast spell

`get_tags`

Get tags list

`create_tag`

Create tag

`get_pets`

获取宠物列表

`feed_pet`

喂养宠物

`hatch_pet`

孵化宠物

`get_mounts`

获取坐骑列表

`equip_item`

装备物品

`get_notifications`

获取通知列表

`read_notification`

标记通知为已读

`get_shop`

获取商店物品

`buy_item`

购买商店物品

`add_checklist_item`

Add checklist item to task

`update_checklist_item`

Update checklist item

`delete_checklist_item`

Delete checklist item

`get_task_checklist`

Get task checklist items

`score_checklist_item`

Score checklist item (mark complete/incomplete)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "habitica mcp server": {
            "habitica-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "habitica-mcp-server"
                ],
                "env": {
                    "HABITICA_USER_ID": "your-id",
                    "HABITICA_API_TOKEN": "your-token"
                }
            }
        }
    }
}

McpServers

{
    "habitica-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "habitica-mcp-server"
        ],
        "env": {
            "HABITICA_USER_ID": "your-id",
            "HABITICA_API_TOKEN": "your-token"
        }
    }
}

✨ Features

🎮 Core Gameplay Features

- 📋 Smart task management – create / view / update / delete all task types - 🎯 Habit tracking – record habit completions and build healthy routines - 🐾 Pet raising – hatch and feed pets, watch them grow - 🏇 Mount collection – manage and equip all kinds of mounts - 🛍️ Shop & rewards – browse and buy in-game items - ⚡ Skill system – cast class skills to enhance gameplay

📊 Data-oriented Features

- 👤 User profile – fetch detailed user information and stats - 🏷️ Tag management – create and manage tags for better organisation - 📬 Notification centre – read and manage system notifications - 📦 Inventory – list every item and piece of equipment you own

🤖 AI Integration Highlights

- 🧠 Natural-language control – operate Habitica via conversation - 📝 Task suggestions – AI can create tasks on demand - 📈 Progress reporting – automatically track and summarise progress - 🎨 Personalised experience – tailored recommendations based on your habits

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_user_profile

get_tasks

create_task

score_task

update_task

delete_task

get_stats

buy_reward

get_inventory

cast_spell

get_tags

create_tag

get_pets

feed_pet

hatch_pet

get_mounts

equip_item

get_notifications

read_notification

get_shop

buy_item

add_checklist_item

update_checklist_item

delete_checklist_item

get_task_checklist

score_checklist_item

Claude Desktop / Cursor

McpServers

✨ Features

🎮 Core Gameplay Features

📊 Data-oriented Features

🤖 AI Integration Highlights

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`get_user_profile`

`get_tasks`

`create_task`

`score_task`

`update_task`

`delete_task`

`get_stats`

`buy_reward`

`get_inventory`

`cast_spell`

`get_tags`

`create_tag`

`get_pets`

`feed_pet`

`hatch_pet`

`get_mounts`

`equip_item`

`get_notifications`

`read_notification`

`get_shop`

`buy_item`

`add_checklist_item`

`update_checklist_item`

`delete_checklist_item`

`get_task_checklist`

`score_checklist_item`