Developers · MCP

Talk to Oden from your editor

@heyoden/mcp is a Model Context Protocol server that connects Claude Code, Cursor, and any MCP client to your Oden account. 17 tools for todos, tags, reminders, and stats. Your AI assistant gets full read/write access to the same data you see in the app.

Quickstart View on npm

@heyoden/mcp@1.0.1
17 tools
Trial · Pro · Max

Quickstart

Three steps. About two minutes.

1
Generate an API key
Open Oden on iPhone or Mac. Go to Settings → Developer → New key. Give it a label like claude-code-laptop. Copy the token shown on screen — you only see it once.
odn_live_•••••••••••••••••••

Add it to your MCP client

Drop the same block into whichever client you use. Replace odn_live_... with your token. Restart the client so it picks up the new config.

Claude Code · ~/.claude/.mcp.json

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

Cursor · ~/.cursor/mcp.json

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

Claude Desktop · ~/Library/Application Support/Claude/claude_desktop_config.json

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

3
Try it
Ask your assistant something that needs your data. It should call an Oden tool and answer from what it finds.
“What are my top todos for today?”
“Create a todo to call the dentist tomorrow at 10.”
“Mark everything in the Errands tag as done.”

Tools

17 tools, three surface areas

Anything you can do in the Oden app, your assistant can do through MCP. The chat endpoint and AI quotas stay app-only — API keys can’t drain them.

Todos

Read, create, update, complete, delete, search, and reparent.

oden_list_todoslist with status + tag filters
oden_create_todotitle, description, tags, priority, due, reminder
oden_update_todopatch any field by UUID
oden_complete_todomark done (cascades to children)
oden_delete_todotwo-step confirm delete
oden_search_todosfull-text across title + description + tags
oden_reparent_todomove under a parent or detach
oden_suggest_todosAI-curated focus list for today

Tags & reminders

Organize and schedule. Reminder tools are legacy — prefer todo remindAt.

oden_list_tagslist tags with colors
oden_create_tagcreate a tag with a color
oden_list_reminderspending reminders
oden_create_reminderstandalone reminder (legacy)
oden_snooze_remindersnooze by N minutes
oden_delete_reminderdelete a reminder

Profile & stats

Read-only context about the account.

oden_get_profilename, email, plan
oden_get_billingsubscription status, trial end
oden_get_statscompletions, streaks, most productive day

API keys

Generated in the app, stored as SHA-256 hashes on our server. The full token is shown to you once and never again. Revoke from Settings → Developer — revoked keys stop working immediately.

Plans

Trial, Pro ($9.99/mo), and Max ($17.99/mo) all get full MCP access. Free accounts (post-trial) return 402. The MCP doesn’t call AI providers, so it never counts against your in-app chat quota.

Security

Treat the token like a password. Don’t commit it to git, don’t paste it into chat. Worst case from a leak: the attacker reads/writes your todos until you revoke. API keys can’t manage other keys.

Environment

Variables you can set

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 a fallback. Migrate to `ODEN_API_KEY`.

Get started

Generate a key from inside the app

You need Oden on iPhone or Mac to mint an API key. Same login across devices, Universal Purchase, free 10-day trial.

Download for iOS & Mac npx @heyoden/mcp