monthlet

monthlet MCP サーバー

Claude Code、Claude Desktop、その他の MCP クライアントから、monthlet の保管庫にあるノートを利用できます。ノートの検索や閲覧に加え、許可した場合は作成や編集もできます。

MCP サーバーは、お使いのコンピューター上の monthlet アプリ内で動作します。このリポジトリには、MCP クライアントが標準入出力（stdio）経由で起動する小さなブリッジ（monthlet-mcp.cjs）が含まれています。ブリッジは各メッセージを 127.0.0.1 経由でアプリに転送するだけです。インターネットには何も送信しません。

必要条件

• 起動中の monthlet for macOS または Windows
• monthlet で MCP サーバーを有効にすること：Settings > Connectors > Publish to external agents > Publish
• Node.js 18 以降（ブリッジにその他の依存関係はありません）

monthlet が起動していない場合、または MCP サーバーがオフの場合、すべてのツール呼び出しはその旨を示すエラーを返します。

サーバーでできること

公開すると、すぐに読み取りが有効になります。書き込み、移動と名前変更、削除には、それぞれ同じ設定セクション内に個別のスイッチがあり、すべてデフォルトでオフになっています。

スイッチ	ツール
公開（読み取り専用）	search_notes、list_notes、read_note、grep_notes、list_folders、list_files、get_backlinks、list_attachments、view_image、read_pdf、read_file、read_chart_data、read_sheet_range
書き込みを許可	create_note、update_note、edit_note、update_tags、create_folder、create_sheet、apply_sheet_edits、add_attachment
移動と名前変更を許可	move_note、move_folder、rename_note、rename_folder
削除を許可	delete_note、delete_folder、merge_notes（削除した項目はシステムのゴミ箱に移動します）

すべてのツールには MCP ツールのアノテーション（readOnlyHint、destructiveHint）が付いているため、クライアントはノートを変更するツールを実行する前に確認できます。

インストール

Claude Code プラグイン

Claude のプラグインディレクトリから、または Claude Code でこのリポジトリから monthlet をインストールします。

/plugin install monthlet --marketplace t27d/monthlet-mcp

プラグインは node ${CLAUDE_PLUGIN_ROOT}/monthlet-mcp.cjs を実行します。

Claude Code で手動インストール

このリポジトリをクローンしてから、次を実行します。

claude mcp add --scope user monthlet -- node /path/to/monthlet-mcp/monthlet-mcp.cjs

macOS では、アプリ内のコピーも使用できます。monthlet には Settings > Connectors > Publish to external agents > Setup に正確なコマンドが表示されます。

Claude Desktop およびその他のクライアント

Node.js でブリッジを実行する stdio サーバーを追加します。Claude Desktop の claude_desktop_config.json では、次のように設定します。

{
  "mcpServers": {
    "monthlet": {
      "command": "node",
      "args": ["/path/to/monthlet-mcp/monthlet-mcp.cjs"]
    }
  }
}

Windows では、パスのバックスラッシュをエスケープして記述します。例："C:\\Users\\you\\monthlet-mcp\\monthlet-mcp.cjs"。

接続方法

MCP サーバーがオンの間、monthlet は現在のポートとアクセストークンを記載した接続ファイルをユーザーデータフォルダーに書き込み、停止時にそのファイルを削除します。

• macOS：~/Library/Application Support/monthlet/mcp-endpoint.json
• Windows：%APPDATA%\monthlet\mcp-endpoint.json。Microsoft Store 版では、同じパスが %LOCALAPPDATA%\Packages\t27d.monthlet_*\LocalCache\Roaming 内にあります。

ブリッジは接続のたびにこのファイルを読み取るため、トークンがクライアントの設定に含まれることはありません。また、monthlet でトークンを再生成しても、クライアント側で変更する必要はありません。

ライセンス

MIT。monthlet 自体はオープンソースではありません。このリポジトリの対象はブリッジのみです。