JRedrupp/habitica-simple-mcp

Use Habitica from Claude on your phone. No local install, deploys in about 2 minutes.
A single-file MCP server for Habitica, written as a dependency-free Cloudflare Worker. Everything lives in worker.js: paste it into the Cloudflare dashboard and you have a remote MCP server for Claude (or any MCP client that supports remote HTTP servers).
## Tools
| Tool | Description |
| get_stats | Player stats (HP, MP, XP, gold, level, class) |
| get_today | One-call overview: dailies due, overdue and soon-due to-dos, HP and damage status. |
| list_tasks | List habits, dailies, to-dos and rewards |
| get_task | Fetch one task |
| get_task_history | Score history of a habit or daily |
| create_task | Create a habit, daily, to-do or reward |
| create_tasks | Create up to 50 tasks in one call |
| find_task | Find tasks by title, notes or checklist |
| update_task | Edit a task; replace or reorder its checklist |
| score_task | Complete / score a task (up or down) |
| move_task | Reorder a task |
| delete_task | Delete a task |
| checklist_item | Add, edit or remove checklist items |
| score_checklist_item | Tick a checklist item |
| list_tags / create_tag / tag_task | Manage tags |
| set_sleep | Pause or resume damage (inn) |
| buy_health_potion | Buy a health potion |
| cast_spell | Cast a class skill |
Task responses are slimmed down to the useful fields, since the raw Habitica task object is very large.
## Setup
1. Click the Deploy to Cloudflare button above (it will ask for the three secrets in step 2), or in the Cloudflare dashboard go to Workers & Pages → Create → Create Worker, then Edit code and paste in the contents of worker.js. Deploy.
2. Under Settings → Variables and Secrets add three secrets:
| Name | Value |
| HABITICA_USER_ID | Your User ID from Habitica → Settings → Site Data → API |
| HABITICA_API_TOKEN | Your API token from the same page |
| MCP_SECRET | A long random string (at least 24 characters), e.g. openssl rand -hex 24 |
Optionally set HABITICA_API_BASE to point at a different Habitica API (defaults to https://habitica.com/api/v3).
Temporary Habitica errors are retried inside the server (up to 3 times with backoff). 429 is always retried and honors Retry-After; 5xx and network errors are retried for everything except POST, to avoid double-scoring or duplicate creates. HABITICA_RETRY_BASE_MS (default 500) sets the base delay.
Habitica API reference: habitica.com/apidoc (source of the doc blocks: tasks.js).
3. Your MCP endpoint is:
https:// . .workers.dev/mcp/
4. Add it to your client as a remote MCP server. With Claude Code:
claude mcp add --transport http habitica https:// . .workers.dev/mcp/
In Claude.ai, add it as a custom connector using the same URL.