Kenotex MCP server

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

server talks to the Mac.

• macOS 26 or later — the app's minimum. The iPhone app syncs over iCloud, but the MCP

• 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/claudedesktopconfig.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

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

Shortened. The full README is on GitHub.