mcp-standardnotes

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

機能

ツール	機能
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	1 回の同期プッシュで最大 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
• protocol 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 キーチェーンに保存され、以降の実行では自動的に再利用されます。login の最後に、Claude Desktop へのサーバー登録を一度の操作で行うかどうかを尋ねられます。承認して Desktop を再起動すれば完了です。

3. Claude に接続する

Claude Desktop（macOS / Windows） — 最も簡単な方法は、次を実行することです。

mcp-standardnotes-install

適切なエントリー（Node とバイナリの絶対パス、およびキーチェーンに保存されているメールアドレス）を ~/Library/Application Support/Claude/claude_desktop_config.json（Windows の場合は %APPDATA%/Claude/claude_desktop_config.json）に書き込みます。既存の設定がある場合は、最初にバックアップします。Claude Desktop を完全に終了（⌘Q）してから、再起動してください。

Claude Code — claude CLI に設定させます。

mcp-standardnotes-install code   # prints the exact `claude mcp add` command

または、~/.claude.json / .mcp.json に手動で追加します。

{
  "mcpServers": {
    "mcp-standardnotes": {
      "type": "stdio",
      "command": "mcp-standardnotes",
      "env": { "SN_EMAIL": "[email protected]" }
    }
  }
}

その後、/mcp を実行して再接続します。

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

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

リモートエージェント（VPS 上の Hermes、セルフホストの LangGraph など）にボルトを使わせたいですか？ Cloudflare Tunnel + MCP Portals の設定全体については、docs/remote-agent-bridge.md を参照してください。マスターキーは Mac 上に保持されます。エージェントは Cloudflare サービストークンで保護された公開 HTTPS エンドポイントと通信し、Portals が MCP ツールの自動検出、複数サーバーのバンドル、Access アプリケーションの生成を処理します。

設定

変数	デフォルト	説明
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 で検証されます。
• CI では、npm audit の HIGH/CRITICAL はマージをブロックします。
• プロトコル 004 の フレーミング のみをローカルで実装しており、すべての暗号プリミティブは libsodium-wrappers-sumo から提供されます。

脅威モデルの全文と詳細な解説：docs/protocol-004.md。 セキュリティポリシー、脆弱性の報告方法、依存関係に関する勧告：SECURITY.md。

トラブルシューティング

よくある問題と解決方法：docs/troubleshooting.md。

ログアウト

[email protected] mcp-standardnotes-logout
# or, from a clone:
[email protected] npm run logout

ロードマップ

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

貢献

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

ライセンス

MIT — 使用、フォーク、配布は自由です。

クレジット

• 暗号化設計と公開 API を提供する Standard Notes。
• MCP SDK を提供する Model Context Protocol と Anthropic。
• Frank Denis による libsodium。libsodium-wrappers-sumo 経由で利用しています。