kenotex-mcp

Let your coding agent manage your real todos, calendar, and habits.

Kenotex is a native planner for Mac and iPhone. This package is its MCP server: point Claude Code, Claude Desktop, Cursor, Zed, or any MCP client at it, and the agent works on the actual items in the app — creating todos with categories and recurrence, scheduling calendar events, ticking off daily or interval check-in habits. Not a scratchpad, not a markdown file. Everything lives in a local SQLite database on your own machine.

Your agent writes on your Mac. It's on your iPhone via iCloud.

Works with Claude Code, Claude Desktop, Cursor, Zed, OpenClaw, and anything else that speaks MCP over stdio.

Get the app

These tools drive the Kenotex macOS app — it hosts the local server this package talks to, so you need it installed and running. Free to download, with in-app purchases.

The MCP integration is not one of those purchases. Every tool in this package talks to the app's local HTTP server, which has no subscription gate — the whole integration works on the free tier.

→ kenxcomp.com/kenotex

Prerequisites

• macOS 26 or later — the app's minimum. The iPhone app syncs over iCloud, but the MCP server talks to the Mac.
• The Kenotex macOS app must be running (it hosts the local HTTP server on port 21519).
• Node.js 20+ or Bun.

Install

Globally:

npm install -g kenotex-mcp
# or
bun add -g kenotex-mcp

Or use it directly via npx / bunx (no install):

npx kenotex-mcp

Configure in an MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kenotex": {
      "command": "npx",
      "args": ["-y", "kenotex-mcp"]
    }
  }
}

Restart Claude Desktop. You'll see the Kenotex tools appear in the 🛠️ menu.

Cursor / Zed / OpenClaw

Same pattern: point the MCP config at kenotex-mcp as the command.

Environment overrides

• KENOTEX_HOST — override base URL (default http://127.0.0.1:21519).
• KENOTEX_TOKEN — skip filesystem token discovery and use this token.

Tools exposed

create_todo requires a categoryId — todos can no longer be created uncategorized. The flow is: call list_categories and reuse a matching category's id; if none fits, call create_category and use the returned id, then create_todo.

Habits are check-in trackers (medication, water, stretching) — daily by default (up to 6 dose times/day), or interval (Q times every N days / N times a week / N times a month) via cadence. Use create_habit for routines the user ticks off; use create_todo + recurrence for one-off tasks or fixed-slot schedules (a particular weekday, a particular day of the month) — cadence counts how many times per period, recurrence pins which day. Writes take times: ["HH:mm", …]; reads return times: [{id, time}] — pass a slot's id as slotId to set_habit_check for a multi-dose habit (omit it to check all of today's doses). cadence: {"unit":"day"|"week"|"month","interval":N,"quota"?:Q,"startDate"?:"yyyy-MM-dd"} makes an interval habit — quota defaults to 1, out-of-range is a 422 and is never clamped, startDate defaults to today and can never be changed afterwards, and a

... View full README on GitHub