How should habitica-mcp-server be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

habitica-mcp-server answer-first brief

Model Context Protocol server for Habitica API integration. Enable AI assistants to manage your Habitica tasks, habits, pets, and rewards through natural language. Habitica MCP Server _中文文档请阅读 **$1**_ 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. ✨ Features 🎮 Core Gameplay Features - 📋 **Smart task management** – create / view / update / delete all task types - ✅ **Checklist management** – add, update, delete and score checklist items within task Published capability contract available. No trust telemetry is available yet. 9 GitHub stars reported by the source. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

habitica-mcp-server is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 93/100

habitica-mcp-server

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal9 GitHub stars

Published capability contract available. No trust telemetry is available yet. 9 GitHub stars reported by the source. Last updated 2/24/2026.

9 GitHub starsSchema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Ibreaker

Artifacts

Benchmarks

Last release

0.0.5

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. 9 GitHub stars reported by the source. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/iBreaker/habitica-mcp-server.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Ibreaker

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Adoption (1)

Adoption signal

9 GitHub stars

profilemedium

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

bash

git clone https://github.com/ibreaker/habitica-mcp-server.git
cd habitica-mcp-server

bash

npm install

bash

npm start

bash

export HABITICA_USER_ID="your-user-id"
export HABITICA_API_TOKEN="your-api-token"

bash

HABITICA_USER_ID=your-user-id
HABITICA_API_TOKEN=your-api-token

bash

# Production
npm start

# Development (with reload)
npm run dev

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

Habitica MCP Server

中文文档请阅读 README.zh-CN.md

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.

✨ Features

🎮 Core Gameplay Features

📋 Smart task management – create / view / update / delete all task types
✅ Checklist management – add, update, delete and score checklist items within tasks
🎯 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

🚀 Quick Start

Prerequisites

Node.js 18+
npm or yarn
A valid Habitica account

Installation

Clone the repo

git clone https://github.com/ibreaker/habitica-mcp-server.git
cd habitica-mcp-server

Install dependencies

npm install

Set API credentials (see next section)
Start the server

npm start

⚙️ Configuration

Get Habitica API credentials

Log into Habitica
Click your avatar → Settings
Open the API tab
Copy User ID and API Token

Environment variables

Method A: export variables

export HABITICA_USER_ID="your-user-id"
export HABITICA_API_TOKEN="your-api-token"

Method B: .env file

HABITICA_USER_ID=your-user-id
HABITICA_API_TOKEN=your-api-token

⚠️ Security tip: never commit your API keys to version control.

🎯 Usage

Start the server

# Production
npm start

# Development (with reload)
npm run dev

MCP client integration

The server follows the MCP spec and works with any AI client that supports MCP. Example Claude Desktop config:

{
  "mcpServers": {
    "habitica-mcp-server": {
      "command": "npx",
      "args": ["-y", "habitica-mcp-server"],
      "env": {
        "HABITICA_USER_ID": "your-id",
        "HABITICA_API_TOKEN": "your-token",
        "MCP_LANG": "en"  // or zh-CN
      }
    }
  }
}

Example dialogue

User: "Create a habit for learning Python"
AI:   "Sure, the habit has been created!"

User: "Show me today's tasks"
AI:   "Here is your task list for today…"

User: "Add a checklist item to my project task: 'Review code'"
AI:   "Added checklist item 'Review code' to your project task!"

User: "I finished my workout, please record it"
AI:   "Great job! The workout is logged."

🛠️ Available Tools

User Related

get_user_profile: Get user profile information
get_stats: Get user statistics
get_inventory: Get inventory list

Task Management

get_tasks: Get task list (can specify type: habits, dailys, todos, rewards)
create_task: Create new task
update_task: Update task
delete_task: Delete task
score_task: Complete task or record habit

Checklist Management

get_task_checklist: Get checklist items for a task
add_checklist_item: Add checklist item to task
update_checklist_item: Update checklist item
delete_checklist_item: Delete checklist item
score_checklist_item: Score checklist item (mark complete/incomplete)

Tag Management

get_tags: Get tag list
create_tag: Create new tag

Pets and Mounts

get_pets: Get pet list
feed_pet: Feed pet
hatch_pet: Hatch pet
get_mounts: Get mount list
equip_item: Equip pet, mount or equipment

Shop and Purchases

get_shop: Get shop item list
buy_item: Buy shop item
buy_reward: Buy reward

Notification Management

get_notifications: Get notification list
read_notification: Mark notification as read

Skill System

cast_spell: Cast spell

📖 API Usage Examples

Create Task

{
  "type": "todo",
  "text": "Complete project documentation",
  "notes": "Including API docs and user guide",
  "difficulty": 1.5,
  "priority": 2,
  "checklist": [
    {"text": "Write API documentation", "completed": false},
    {"text": "Create user guide", "completed": false},
    {"text": "Review and proofread", "completed": false}
  ]
}

Complete Task

{
  "taskId": "task-id-here",
  "direction": "up"
}

Get Specific Task Type

{
  "type": "todos"
}

Pet Management

{
  "pet": "Wolf-Base",
  "food": "Meat"
}

Buy Item

{
  "itemKey": "armor_warrior_1",
  "quantity": 1
}

Checklist Management

// Add checklist item
{
  "taskId": "task-id-here",
  "text": "Research requirements"
}

// Update checklist item
{
  "taskId": "task-id-here",
  "itemId": "checklist-item-id",
  "text": "Updated item text",
  "completed": true
}

// Score checklist item (toggle completion)
{
  "taskId": "task-id-here",
  "itemId": "checklist-item-id"
}

Task Types

habit: Habit (can be recorded positively or negatively)
daily: Daily task (resets every day)
todo: To-do item (one-time task)
reward: Reward (can be purchased with gold)

Difficulty Levels

0.1: Easy
1: Medium
1.5: Hard
2: Extreme

Priority Levels

0.1: Low
1: Medium
1.5: High
2: Extreme

🔧 Troubleshooting

Common Issues

Issue: Server startup failed

Solution: 
1. Check Node.js version is 18+
2. Confirm environment variables are set correctly
3. Verify API credentials are valid

Issue: API call failed

Solution:
1. Check network connection
2. Verify Habitica API credentials
3. Confirm API rate limits haven't been exceeded

Issue: Task or pet not found

Solution:
1. Confirm task ID is correct
2. Check if task exists in Habitica
3. Verify user permissions

Debug Mode

# Enable verbose logging
DEBUG=* npm start

Get Help

📚 Check Habitica API Documentation
🐛 Submit Issues

🤝 Contributing

We welcome all forms of contributions!

How to Contribute

Fork this project
Create feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add some AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Create Pull Request

Development Guidelines

Follow existing code style
Add appropriate tests
Update relevant documentation
Ensure all tests pass

📄 License

This project is open source under the MIT License - see the LICENSE file for details.

🌟 Acknowledgments

Thanks to Habitica for providing an excellent API
Thanks to Anthropic for the MCP protocol
Thanks to all contributors and users for their support

<div align="center"> <b>Let AI become your Habitica task management assistant!</b> </div>

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/iBreaker/habitica-mcp-server#input",
  "outputSchemaRef": "https://github.com/iBreaker/habitica-mcp-server#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:15.559Z",
  "sourceUpdatedAt": "2026-02-24T19:46:15.559Z",
  "freshnessSeconds": 4443629
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T06:06:45.150Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "habitica",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "productivity",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "habits",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ai",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "task-management",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "rpg",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "claude",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "assistant",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "automation",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "gamification",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:habitica|supported|profile capability:productivity|supported|profile capability:habits|supported|profile capability:ai|supported|profile capability:task-management|supported|profile capability:rpg|supported|profile capability:model-context-protocol|supported|profile capability:claude|supported|profile capability:assistant|supported|profile capability:automation|supported|profile capability:gamification|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:15.559Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:15.559Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/iBreaker/habitica-mcp-server#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:15.559Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Ibreaker",
    "href": "https://github.com/ibreaker/habitica-mcp-server#readme",
    "sourceUrl": "https://github.com/ibreaker/habitica-mcp-server#readme",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "9 GitHub stars",
    "href": "https://github.com/iBreaker/habitica-mcp-server",
    "sourceUrl": "https://github.com/iBreaker/habitica-mcp-server",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-ibreaker-habitica-mcp-server/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]