kenotex-mcp

kenotex-mcp

コーディングエージェントに、実際の todo、カレンダー、習慣を管理させましょう。

Kenotex は、Mac と iPhone 向けのネイティブプランナーです。 このパッケージはその MCP サーバーです。Claude Code、Claude Desktop、Cursor、Zed、その他の MCP クライアントから接続すると、エージェントはアプリ内の実際の項目を操作できます。カテゴリーや繰り返しを設定した todo の作成、カレンダーイベントのスケジュール、毎日または一定間隔のチェックイン習慣の記録が可能です。 メモ帳でも、Markdown ファイルでもありません。すべてはお使いのマシン上のローカル SQLite データベースに保存されます。

エージェントは Mac 上で書き込みます。iCloud 経由で iPhone でも利用できます。

Claude Code、Claude Desktop、Cursor、Zed、OpenClaw など、stdio 経由で MCP を使用するあらゆるクライアントで動作します。

アプリを入手する

これらのツールは Kenotex macOS アプリを操作します。このアプリが本パッケージの接続先となるローカルサーバーをホストするため、インストールして起動しておく必要があります。無料でダウンロードでき、アプリ内課金があります。

MCP 連携は、課金対象の機能ではありません。 このパッケージのすべてのツールは、サブスクリプションの制限がないアプリのローカル HTTP サーバーと通信するため、無料プランで連携の全機能を利用できます。

→ kenxcomp.com/kenotex

前提条件

• macOS 26 以降 — アプリの最低要件です。iPhone アプリは iCloud 経由で同期しますが、MCP サーバーは Mac と通信します。
• Kenotex macOS アプリが起動している必要があります（ポート 21519 でローカル HTTP サーバーをホストします）。
• Node.js 20+ または Bun。

インストール

グローバルにインストールする場合：

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

または npx / bunx 経由で直接使用します（インストール不要）：

npx kenotex-mcp

MCP クライアントで設定する

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

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

Claude Desktop を再起動します。🛠️ メニューに Kenotex のツールが表示されます。

Cursor / Zed / OpenClaw

同じ方法で、MCP 設定の command として kenotex-mcp を指定します。

環境変数による上書き

• KENOTEX_HOST — ベース URL を上書きします（デフォルトは http://127.0.0.1:21519）。
• KENOTEX_TOKEN — ファイルシステムからのトークン検出をスキップし、このトークンを使用します。

公開されるツール

カテゴリー	ツール
Todo	create_todo list_todos get_todo update_todo complete_todo delete_todo
イベント	create_event list_events get_event update_event delete_event
習慣	create_habit list_habits get_habit update_habit set_habit_check list_habit_checks delete_habit
カテゴリー	list_categories create_category
リマインダー	add_reminder remove_reminder

create_todo には categoryId が必須です — カテゴリーなしで todo を作成することはできなくなりました。手順は次のとおりです。list_categories を呼び出し、一致するカテゴリーの id を再利用します。該当するカテゴリーがなければ、create_category を呼び出して返された id を使い、その後 create_todo を呼び出します。

習慣はチェックインを記録するトラッカーです（服薬、水分補給、ストレッチなど）。デフォルトは毎日（1 日最大 6 回の時刻を設定可能）で、cadence を使って一定間隔（N 日ごとに Q 回／週に N 回／月に N 回）にも設定できます。ユーザーがチェックを付けるルーティンには create_habit を使用します。単発のタスクや特定の曜日・月内の特定日に固定するスケジュールには、繰り返しを設定した create_todo を使用します。cadence は期間あたりの回数を数え、繰り返し設定は曜日を固定します。書き込みでは times: ["HH:mm", …] を指定し、読み取りでは times: [{id, time}] が返されます。複数回服用する習慣では、set_habit_check にスロットの id を slotId として渡します（省略すると、本日分のすべての服用をチェックします）。cadence: {"unit":"day"|"week"|"month","interval":N,"quota"?:Q,"startDate"?:"yyyy-MM-dd"} を指定すると、一定間隔の習慣になります。quota のデフォルトは 1 で、範囲外の値を指定すると 422 エラーになり、上限・下限への自動調整は行われません。startDate のデフォルトは今日で、後から変更することはできません。また、一定間隔の習慣に設定できる服用時刻は最大 1 つです。

unit	interval	quota	期間
day	1–365	1–interval	N 暦日。したがって quota ≤ N です。day/1 では quota 1 が「明示的に毎日」を意味します
week	1–8	1–7×interval	N 週間
month	1–12	1–min(31×interval, 365)	N 暦月（1日から末日まで）。そのため期限日は常に月末となり、期間の長さは固定の30日ではなく暦に従います

例：{"unit":"day","interval":3} = 3日ごと · {"unit":"day","interval":5,"quota":2} = 5日ごとに2回 · {"unit":"week","interval":1,"quota":2} = 週2回 · {"unit":"month","interval":1,"quota":2} = 月2回。

読み取り結果には cadence、isIntervalHabit、currentPeriod {start,end,dueDay,doneCount,quota,done} が追加されます（quota は期間内で実際に有効な割り当て数です。設定された quota を、startDate 以降にチェック可能な日数に合わせて調整します。そのため、月31日の習慣は2月には28と表示され、14日に開始した最初の月は17と表示されます）。「この期間の目標を達成したかどうか」には currentPeriod.done を使用してください（checkedToday は暦日の事実のままです）。update_habit {"cadence": null} を指定すると、基準日を保持したままインターバル習慣を毎日の習慣に戻します。インターバル習慣のチェックは暦日単位です（slotId はなく、date に未来の日付は指定できません）。チェックは明示的な 状態設定（checked: true|false、date の既定値は今日、冪等。false でチェックを解除）です。delete_habit は習慣とそのすべてのチェックイン履歴を完全に削除します。記録を保持したまま停止するには、代わりに update_habit で endDate を設定してください。

アプリのバージョン：習慣ツールには、/v1/habits を提供する Kenotex アプリのリリース（1.2.9 以降、ローカル API v2）が必要です。cadence にはさらに、ローカル API v3 を提供するリリースが必要です。古いアプリに対する cadence の書き込みは黙って無視されず、事前に VERSION_SKEW として拒否されます。アプリを更新したら再試行するだけで利用できます（チェック時に実行中のアプリのバージョンを再読み込みするため、MCP の再起動は不要です）。それ以外に制限はありません。v2 アプリでは、習慣ツールを含む他のすべてのツールは以前とまったく同じように動作します。利用できないのは cadence だけです。

繰り返し DSL：'daily' / 'weekly:mon,wed,fri' / 'monthly:15' / 'yearly' / 'after:daily'（todos のみ） / 'none'。

仮想イベントの発生：get_event は {parentId}__occ__{yyyy-MM-dd} のような ID を受け付けます。繰り返しの親イベントを削除すると、過去の発生分が実体化されます。

認証の仕組み

HTTP リクエストごとに、サーバーは次の順序で Kenotex のベアラートークンを読み込みます。

1. ~/Library/Containers/com.kenxcomp.kenotex/Data/Library/Application Support/Kenotex/local-http-token
2. ~/Library/Application Support/Kenotex/local-http-token
3. ~/.kenotex-local-token

トークンは Kenotex アプリの起動ごとにローテーションされるため、古い MCP セッションでも、次にツールを呼び出す際にファイルを再読み込みします。

トラブルシューティング

「Kenotex アプリが起動していないか、トークンにアクセスできません」 — Kenotex.app を起動してください。起動中であれば、上記3つのパスのいずれかにトークンファイルが存在するはずです。

リクエストがタイムアウトする — ファイアウォールが localhost:21519 をブロックしていないか確認してください。ツールのタイムアウトは10秒に固定されています。

ライセンス

MIT © kenxcomp