J
JRedrupp/habitica-simple-mcp
Single-file MCP server for Habitica (Cloudflare Worker)
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"jredrupp-habitica-simple-mcp": {
"command": "npx",
"args": ["wrangler"]
}
}
}Parsed from the README we fetched on 2026-11-08; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"jredrupp-habitica-simple-mcp": {
"command": "npx",
"args": ["wrangler"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio jredrupp-habitica-simple-mcp -- npx wrangler
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · JRedrupp/habitica-simple-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-09 · last seen 2026-11-14 · seen 6× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
- Install
npx wrangler
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx wrangler. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
JRedrupp/habitica-simple-mcp；first catalogued 2026-11-09；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# habitica-simple-mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
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.
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.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/jredrupp-habitica-simple-mcp/)
- Source
- github · https://github.com/JRedrupp/habitica-simple-mcp
- Browse by field
- Open source
- Listed by
- 2 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.