kenotex-mcp
com.kenxcomp · Updated
Let your coding agent manage real todos, events, and check-in habits in Kenotex on your Mac.
At a glance
kenotex-mcp is an MCP server in the AI & Memory category. It runs locally over stdio via `npx -y kenotex-mcp`, and needs KENOTEX_TOKEN. It exposes 3 tools, including day, week and month. It scores A (80/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install kenotex-mcp in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install kenotex-mcp in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add kenotex-mcp -e 'KENOTEX_TOKEN=<KENOTEX_TOKEN>' -- npx -y kenotex-mcpFill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. day, week, month). It discovers them automatically.
How to install kenotex-mcp in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "kenotex-mcp": { "command": "npx", "args": [ "-y", "kenotex-mcp" ], "env": { "KENOTEX_TOKEN": "<KENOTEX_TOKEN>" } } } }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install kenotex-mcp in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "kenotex-mcp": { "command": "npx", "args": [ "-y", "kenotex-mcp" ], "env": { "KENOTEX_TOKEN": "<KENOTEX_TOKEN>" } } } }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install kenotex-mcp in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.kenotex-mcp] command = "npx" args = ["-y", "kenotex-mcp"] env = { KENOTEX_TOKEN = "<KENOTEX_TOKEN>" }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install kenotex-mcp in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "kenotex-mcp": { "command": "npx", "args": [ "-y", "kenotex-mcp" ], "env": { "KENOTEX_TOKEN": "<KENOTEX_TOKEN>" } } } }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install kenotex-mcp in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "kenotex-mcp": { "command": "npx", "args": [ "-y", "kenotex-mcp" ], "env": { "KENOTEX_TOKEN": "<KENOTEX_TOKEN>" } } } }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
How to install kenotex-mcp in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "kenotex-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "kenotex-mcp" ], "env": { "KENOTEX_TOKEN": "<KENOTEX_TOKEN>" } } } }Fill in your credentials
Replace <KENOTEX_TOKEN> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does kenotex-mcp need from you?
API key — Override the auto-discovered local API token. Normally unnecessary — the server finds it on disk.
KENOTEX_TOKENoptionalsecretEnvironment variableOverride the auto-discovered local API token. Normally unnecessary — the server finds it on disk.
KENOTEX_HOSToptionalEnvironment variableOverride the local server address. Defaults to http://127.0.0.1:21519.
Pass secrets through your shell environment rather than committing them into a config file.
What tools does kenotex-mcp expose? (3)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
What the code can do
Read from the published package source — never executed. Parsed 1 of 1 source file.
This server can read and write files, execute code it builds at runtime and make network requests.
How it was published
- No provenance attestation — there is nothing linking this published artifact to a specific source commit.
- 1 npm maintainer — a single point of compromise · last published by zy06637.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit today — Actively maintained.
- Repository created 2 months ago — Very new project with little track record yet.
- 0 GitHub stars — Very little community usage so far.
Client compatibility
Health score
A · 80Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 0 days ago.
- Adoption20%0%
0 stars.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (1.4.0).
Documentation
Full READMEkenotex-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](https://kenxcomp.com/kenotex/?ct=npm-mcp)
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
Excerpt — the full document is on GitHub.
Alternatives to kenotex-mcp
- Agent-Native CalendarA · 88Agent-Native Google Calendar - manage events, sync, and public booking
- inspeximus: agent memory with provenance, GDPR erasure and a tamper-evident audit trailB · 77Self-correcting agent memory: recall, supersede, revert, forget, GDPR erasure, audit receipts.
- Trusty SquireB · 79Provision, ship, and pay from your coding agent — keys and cards never leave the vault.
- Assertion MemoryB · 78Recall your team's coding-agent memory. Install the Assertion plugin to capture it automatically.
Maintain kenotex-mcp? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/com-kenxcomp-kenotex-mcp)Catalog data refreshed . Something wrong? Report it.