mcp-standardnotes

License: MIT Node: ≥20

ClaudeにStandard Notesボルトへの安全な読み取り/書き込みアクセスを提供します。エンドツーエンド暗号化、ローカルstdioのみ、クラウド仲介者ゼロ。

Claudeにノートの要約、新規作成、タグの整理、ボルト全体の検索を依頼できます。マスターキーは常にあなたのマシン内に留まります。Claude Code、Claude Desktop、およびMCP互換クライアントで動作します。

免責事項 本プロジェクトは非公式のサードパーティ製統合ツールです。Standard Notes Ltd.とは提携、推奨、後援を受けていません。「Standard Notes」はStandard Notes Ltd.の商標です。

なぜこれを使うのか

🔒 エンドツーエンド暗号化。 すべての復号は、監査済みのlibsodiumプリミティブ（Argon2id + XChaCha20-Poly1305 IETF）を使用してローカルで行われます。パスワードがRAMから出ることはなく、マスターキーがマシンから出ることもありません。
🔌 ローカルstdioのみ。 このサーバーによってネットワークポートが開かれることはありません。
🔑 セッションストレージにOSキーチェーンを使用。 macOS Keychain、Linux libsecret、Windows Credential Vaultを使用し、プレーンテキストファイルには保存しません。
☁️ 公式クラウドまたはセルフホストの Standard Notesサーバーで動作します。

機能

ツール	内容
`notes_list` / `notes_search` / `notes_get`	ノートの閲覧と検索（`tag: "<uuid-or-title>"`でタグによるフィルタリングが可能）
`notes_create` / `notes_update` / `notes_delete`	ノートの書き込み（markdown、super、code、rich-text、task、spreadsheet、plain-text）
`notes_create_many`	一度の同期プッシュで最大50件のノートを一括作成
`notes_stats`	ボルトの統計：件数、サイズ、最も古い/新しい/大きいノート
`tags_list` / `tags_get` / `tags_create` / `tags_update` / `tags_delete`	タグの完全なCRUD操作
`tags_attach` / `tags_detach`	ノートへのタグのリンク/リンク解除
`sync`	サーバーとの強制同期

notes_createおよびnotes_updateは、書き込み時にタグをリンクするためのオプションのtags: string[]（タグUUID）を受け付けます。

要件

Node.js ≥ 20
プロトコル004を使用するStandard Notesアカウント（2020年以降に作成またはアップグレードされたすべてのアカウントのデフォルト）
OSキーチェーンが動作するmacOS、Linux、またはWindows

クイックスタート

1. インストール

npm install -g mcp-standardnotes

または、クローンから実行する場合：

git clone https://github.com/lozit/mcp-standardnotes.git
cd mcp-standardnotes
npm install && npm run build

2. 1回ログインする

mcp-standardnotes-login         # if installed globally
# or, from a clone:
npm run login

メールアドレスとパスワードの入力を求められます。パスワードはメモリ内でマスターキーを導出（Argon2id）するために使用され、ディスクに書き込まれることはありません。暗号化されたセッションはOSキーチェーンに保存され、以降の実行で自動的に再利用されます。

3. Claudeと接続する

Claude Code — ~/.claude.json または .mcp.json に追加します：

{
  "mcpServers": {
    "mcp-standardnotes": {
      "type": "stdio",
      "command": "mcp-standardnotes",
      "env": { "SN_EMAIL": "you@example.com" }
    }
  }
}

npm install -gの代わりにクローンした場合は、commandをnodeへの絶対パスに置き換え、args: ["/absolute/path/to/mcp-standardnotes/dist/index.js"]を追加してください。

その後、/mcpで再接続します。

Claude Desktop (macOS) — ~/Library/Application Support/Claude/claude_desktop_config.json を同じ構造で編集し、Node ≥ 20バイナリへの絶対パスを使用してください（Claude Desktopはnvmを継承しません）。SyntaxError: Unexpected token '??='が発生した場合は、docs/troubleshooting.mdを参照してください。

その他のMCPクライアント — 環境変数にSN_EMAILを設定してnode dist/index.jsを実行します。トランスポートはstdioです。

Standard Notesをセルフホストしていますか？ docker-composeのレシピとTLS証明書の固定方法については、docs/self-hosted.mdを参照してください。

設定

変数	デフォルト	説明
`SN_EMAIL`	必須	SNアカウントのメールアドレス。`npm run login`で使用したものと一致する必要があります。
`SN_SERVER_URL`	`https://api.standardnotes.com`	同期サーバーのURL。セルフホストインスタンスの場合は変更してください。
`KEYCHAIN_SERVICE`	`mcp-standardnotes`	キーチェーンサービス名を上書きします（複数のアカウントを使用する場合に便利）。
`SN_CERT_FINGERPRINT`	未設定	セルフホストサーバー用のSHA-256 TLS証明書ピン（64桁の16進数、コロンは任意）。docs/self-hosted.mdを参照。

セキュリティの概要

パスワードはキー導出中のRAM内にのみ存在します。ログ記録や保存は一切行われません。
セッションとマスターキーの16進数はOSキーチェーンのみに保存されます。プレーンテキストファイルには保存されません。
stdioトランスポートのみを使用。HTTPポートは一切開きません。
すべてのログはstderrに出力され、パスワード、キー、JWT、トークン風の文字列をマスクするリダクターを通過します。
すべてのツール入力はzodによって検証されます。
npm auditでHIGH/CRITICALの脆弱性がある場合はCIでマージがブロックされます。
プロトコル004のフレーミングのみがローカルで実装されており、すべての暗号化プリミティブはlibsodium-wrappers-sumoから提供されます。

完全な脅威モデルと詳細な分析：docs/protocol-004.md

トラブルシューティング

一般的な問題と解決策：docs/troubleshooting.md

ログアウト

SN_EMAIL=you@example.com mcp-standardnotes-logout
# or, from a clone:
SN_EMAIL=you@example.com npm run logout

ロードマップ

今後の作業はROADMAP.mdで追跡されています。

貢献

貢献を歓迎します。セットアップ、テスト、PRチェックリストについてはCONTRIBUTING.mdを参照してください。

ライセンス

MIT — 自由に使用、フォーク、配布してください。

クレジット

Standard Notes（暗号化設計およびパブリックAPI）
Model Context Protocol および Anthropic（MCP SDK）
libsodium（Frank Denis作、libsodium-wrappers-sumo経由で公開）

Standard Notes