# kenotex-mcp

Connect a coding agent to Kenotex on your Mac to manage todos, calendar events, habit check-ins, and reminders.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: kenxcomp
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kenxcomp/kenotex-mcp
- Updated: 2026-09-15
- HTML: https://affpapa.org/en/nevibecode/mcp/kenotex-mcp

## What it does

kenotex-mcp gives an agent MCP tools for working with items in the Kenotex app. It can create and update todos, schedule events, record habit check-ins, and manage reminders. The app keeps its data in a local SQLite database and syncs with iPhone through iCloud.

You need Kenotex running on a Mac with macOS 26 or later, plus Node.js 20+ or Bun. The server communicates with the app’s local HTTP interface. Todo creation requires a `categoryId`, so the agent must find a suitable category with `list_categories` or create one before calling `create_todo`. That extra step matters when asking the agent to add a task.

Add the server to Claude Code with the command below. `KENOTEX_TOKEN` supplies access credentials; an alternate server address can be set with `KENOTEX_HOST`. Habit tools depend on the app release, and interval cadence requires a release advertising local API v3.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KENOTEX_TOKEN`, `KENOTEX_HOST` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KENOTEX_TOKEN=<KENOTEX_TOKEN> --env KENOTEX_HOST=<KENOTEX_HOST> --transport stdio kenotex-mcp -- npx -y kenotex-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add kenotex-mcp --env KENOTEX_TOKEN=<KENOTEX_TOKEN> --env KENOTEX_HOST=<KENOTEX_HOST> -- npx -y kenotex-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kenotex-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kenotex-mcp"
            ],
            "env": {
                "KENOTEX_TOKEN": "<KENOTEX_TOKEN>",
                "KENOTEX_HOST": "<KENOTEX_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kenotex-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kenotex-mcp"
            ],
            "env": {
                "KENOTEX_TOKEN": "<KENOTEX_TOKEN>",
                "KENOTEX_HOST": "<KENOTEX_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KENOTEX_TOKEN=<KENOTEX_TOKEN> -e KENOTEX_HOST=<KENOTEX_HOST> kenotex-mcp npx -y kenotex-mcp
```
Replace <…> with your own values

## When to use it
- create a categorized todo with recurrence
- schedule an event in the calendar
- record a daily or interval habit check-in
- add a reminder to a plan

## Example prompts
- Create a todo called “Check the build,” choose a suitable category, and repeat it on Mondays.
- Schedule a calendar event for tomorrow: release preparation.
- Mark today’s “Stretching” habit as complete.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md