mcp-standardnotes

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サーバーで動作します。

Related MCP server: claude-bridge

機能

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を参照してください。

設定

セキュリティの概要

• パスワードはキー導出中の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経由で公開）