Rook

rook-mcp

macOS の Rook メモアプリにテキストを保存する Model Context Protocol サーバーです。stdio JSON-RPC 2.0 で通信し、append_to_inbox という 1 つのツールを公開します。

MCP クライアント（Claude Desktop、Cursor、Claude Code、Codex、Gemini CLI など）が append_to_inbox を呼び出すと、このサーバーは共有の macOS アプリグループコンテナに JSON 行を書き込みます。Rook はそのコンテナを読み取り、各行を受信箱のメモに変換します。

インストール

rook-mcp は Rook.app の Contents/Helpers/rook-mcp.app に含まれています。userook.app から Rook をインストールし、MCP クライアントでバンドルされたバイナリを指定してください。

/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Claude Code

どのディレクトリからでもサーバーを使えるよう、ユーザースコープでインストールします。

claude mcp add rook -s user /Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

Codex

codex mcp add rook -- /Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp

または、~/.codex/config.toml に手動で追加します。

[mcp_servers.rook]
command = "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "rook": {
      "command": "/Applications/Rook.app/Contents/Helpers/rook-mcp.app/Contents/MacOS/rook-mcp"
    }
  }
}

Gemini CLI では、サーバーを初めて使用する際に信頼を確認するプロンプトが表示されます。

ツール

append_to_inbox

ユーザーの Rook メモアプリにテキストを保存します。ユーザーが Rook に何かを保存、キャプチャ、記憶、書き留め、記録、追加、または保管するよう求めた場合、モデルはこのツールを呼び出してください。

入力：

フィールド	型	必須	備考
content	文字列	はい	保存するテキストです。最大 100,000 文字です。
title	文字列	いいえ	コンテンツの上に表示する短い見出しです。最大 200 文字です。

応答： Saved to Rook inbox 2026-05-12 under "Test" のような確認メッセージです。

エラー：

コード	スラッグ	意味
-32600	invalid request	jsonrpc のバージョンがない、または誤っている、あるいは initialize の前にメソッドが呼び出されました
-32001	entitlement_unavailable	アプリグループコンテナにアクセスできません（署名されていないビルド）
-32002	rate_limited	過去 60 秒間の書き込みが 100 回を超えました
-32003	paused	Rook で MCP が一時停止されています（Settings → MCP → Resume）
-32004	input_invalid	コンテンツまたはタイトルの検証に失敗したか、params の形式が誤っています
-32005	store_write_failed	受信箱へのファイル書き込みに失敗しました

ビルド

Swift 5.9 以降と macOS 14 以降が必要です。

swift build -c release

生成されたバイナリは、Rook のチーム ID 署名とアプリグループのエンタイトルメントがないため、すべてのツール呼び出しで entitlement_unavailable を返します。Rook にコンテンツを届けられるのは、Rook.app/Contents/Helpers/ 内のバイナリのみです。

セキュリティ

信頼境界、サニタイザー、レート制限、一時停止フラグ、脆弱性の報告ポリシーについては、SECURITY.md を参照してください。