@heyoden/mcp

A Model Context Protocol server for Oden — the AI todo and calendar assistant. Connect it to Claude Code, Cursor, or any MCP client and your AI assistant can read, create, complete, and search your todos directly from chat.

What you get

17 tools across todos, tags, reminders, and your profile. The full list is at the bottom of this file. The short version: anything you can do in the Oden app, you can ask your AI assistant to do via MCP.

Setup

You need an Oden account on the Trial, Pro, or Max plan to use the MCP. Free accounts (post-trial) get a 402.

1. Generate an API key. Open Oden on iPhone or Mac. Settings → Developer → New key. Give it a label (e.g. claude-code-laptop) and save the token shown on screen. You only see it once.

2. Add it to your MCP client config. For Claude Code, edit ~/.claude/.mcp.json:

{
  "mcpServers": {
    "oden": {
      "command": "npx",
      "args": ["-y", "@heyoden/mcp"],
      "env": {
        "ODEN_API_KEY": "odn_live_..."
      }
    }
  }
}

Replace odn_live_... with the key you copied. Restart Claude Code so the new config is picked up.

3. Try it. Ask your AI assistant: "What are my top todos for today?" It should call oden_suggest_todos and read your data back.

Environment

| Variable | Required | Notes | |---|---|---| | ODEN_API_KEY | yes | The odn_live_* token from Settings → Developer | | ODEN_API_URL | no | Override the API base. Default: https://api.heyoden.com/v1 | | ODEN_AUTH_TOKEN | deprecated | Legacy long-lived JWT. Still accepted as fallback. Migrate to ODEN_API_KEY. |

Security

The token grants full read/write access to your Oden account: todos, tags, reminders, stats, profile, billing status. Treat it like a password.

• Don't commit it to git. Add .mcp.json to .gitignore if your project tracks it.
• Don't paste it into chat with anyone (including AI assistants).
• Lost it? Just revoke from Settings → Developer and create a new one. Old tokens stop working immediately.
• API keys can't call the chat endpoint, can't manage other API keys, and can't bypass your subscription's daily AI quota. Worst case from a leak: the attacker reads/writes your todos until you revoke.

Available tools

| Tool | What it does | |---|---| | oden_list_todos | List todos with optional status/tag filters | | oden_create_todo | Create a todo (title, description, tags, priority, due date, reminder) | | oden_update_todo | Update a todo by UUID | | oden_complete_todo | Mark a todo as done | | oden_delete_todo | Delete a todo (two-step confirm) | | oden_suggest_todos | AI-curated focus list for today | | oden_search_todos | Full-text search across title + description + tags | | oden_reparent_todo | Move a todo under a parent or detach it | | oden_list_tags | List your tags with colors | | oden_create_tag | Create a tag with a label and color | | oden_list_reminders | List pending reminders (legacy — prefer todo remindAt) | | oden_create_reminder | Create a standalone reminder (legacy) | | oden_snooze_reminder | Snooze a reminder by N minutes (legacy) | | oden_delete_reminder | Delete a reminder (legacy) | | oden_get_stats | Productivity stats: completions, streaks, most productive day | | oden_get_profile | Your name, email, plan | | oden_get_billing | Subscription status, trial end, plan |

Plans & limits

• Trial (10 days, free): full MCP access.
• Pro ($9.99/mo): full MCP access.
• Max ($17.99/mo): full MCP access.

The MCP itself does not call AI providers, so it does not consume your daily AI quota (Pro 25/day, Max 75/day). Those limits only apply to the in-app chat.

Issues, feature requests

heyoden.com/support

License

MIT