Allows an AI client to securely read, write, search, and organize notes within an end-to-end encrypted Standard Notes vault.
Also known as lozit/mcp-standardnotes
- Stars
- 13
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.6.0
- Last commit
- Sep 8, 2026
- License
- MIT
What is Standard Notes MCP?
Standard Notes allows an AI client to securely read, write, search, and organize notes within an end-to-end encrypted Standard Notes vault.
Summary generated from the project's README
About Standard Notes MCP server
Managing your end-to-end encrypted notes through an AI assistant is possible with this MCP server. It provides Claude Desktop, Claude Code, and other MCP-compatible clients with the ability to interact directly with a Standard Notes vault. Users can perform tasks like searching for specific entries, drafting new content in various formats such as markdown or spreadsheets, and organizing information using tags.
Security is a primary focus, as all decryption occurs locally on your machine using libsodium primitives. Your master key and password never leave your local environment, and session data is stored securely in your OS keychain rather than in plaintext files. The server operates via local stdio, meaning no network ports are opened on your machine. It supports both official cloud accounts and self-hosted Standard Notes instances, provided you use protocol 004. You can manage your entire vault, including batch-creating up to 50 notes at once or checking vault statistics, while maintaining complete privacy.
What you can do with it
- 1Summarize and search existing notesAsk your AI client to find specific information or summarize content across your entire encrypted vault.
- 2Organize information with tagsInstruct the AI to create, update, or attach tags to your notes to keep your vault structured.
- 3Bulk create new contentHave the AI generate and save multiple notes simultaneously to your vault in a single sync.
- 4Monitor vault health and sizeRequest a summary of your vault statistics including note counts and file sizes.
Written from the project's README. Every use case is checked against a quote from it.
How to install Standard Notes MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Standard Notes MCP in Claude Code
$ claude mcp add --env 'SN_EMAIL=<SN_EMAIL>' mcp-standardnotes -- npx -y mcp-standardnotesInstall Standard Notes MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-standardnotes": {
"command": "npx",
"args": [
"-y",
"mcp-standardnotes"
],
"env": {
"SN_EMAIL": "<SN_EMAIL>"
}
}
}
}Install Standard Notes MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-standardnotes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-standardnotes"
],
"env": {
"SN_EMAIL": "<SN_EMAIL>"
}
}
}
}Install Standard Notes MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-standardnotes","type":"stdio","command":"npx","args":["-y","mcp-standardnotes"],"env":{"SN_EMAIL":"<SN_EMAIL>"}}'Install Standard Notes MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-standardnotes": {
"command": "npx",
"args": [
"-y",
"mcp-standardnotes"
],
"env": {
"SN_EMAIL": "<SN_EMAIL>"
}
}
}
}Install Standard Notes MCP in Codex
$ codex mcp add mcp-standardnotes --env 'SN_EMAIL=<SN_EMAIL>' -- npx -y mcp-standardnotesInstall Standard Notes MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-standardnotes] command = "npx" args = ["-y", "mcp-standardnotes"] [mcp_servers.mcp-standardnotes.env] SN_EMAIL = "<SN_EMAIL>"
Install Standard Notes MCP in Gemini CLI
$ gemini mcp add -s user -e 'SN_EMAIL=<SN_EMAIL>' mcp-standardnotes npx -- -y mcp-standardnotesInstall Standard Notes MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-standardnotes": {
"command": "npx",
"args": [
"-y",
"mcp-standardnotes"
],
"env": {
"SN_EMAIL": "<SN_EMAIL>"
}
}
}
}Configuration
SN_EMAILRequiredStandard Notes account email. The password is prompted once via `npx mcp-standardnotes-login` and the session is persisted in the OS keychain.
SN_CERT_FINGERPRINTOptional SHA-256 TLS certificate fingerprint for pinning a self-hosted server.
SN_SERVER_URLStandard Notes sync server URL. Defaults to the official cloud if unset.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablelozit/mcp-standardnotes is public and reachablegithub.com/lozit/mcp-standardnotes ↗Pass
- Package names this repository as its sourcemcp-standardnotes names lozit/mcp-standardnotes as sourcenpmjs.com/package/mcp-standardnotes ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for mcp-standardnotesnpmjs.com/package/mcp-standardnotes/v/0.6.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-08github.com/lozit/mcp-standardnotes ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from mcp-standardnotesPass
- No critical advisory in the package or its dependencies136 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubmcp-standardnotes
Give Claude secure read/write access to your Standard Notes vault — end-to-end encrypted, local stdio only, zero cloud middleman.
Ask Claude to summarize your notes, draft new ones, organize tags, search across your vault — all while your master key stays on your machine. Works with Claude Code, Claude Desktop, and any MCP-compatible client.
Disclaimer. This is an unofficial third-party integration. Not affiliated with, endorsed by, or sponsored by Standard Notes Ltd. "Standard Notes" is a trademark of Standard Notes Ltd.
Why
- 🔒 End-to-end encrypted. All decryption happens locally using audited libsodium primitives (Argon2id + XChaCha20-Poly1305 IETF). Your password never leaves RAM; your master key never leaves your machine.
- 🔌 Local stdio only. No network port is ever opened by this server.
- 🔑 OS keychain for session storage. macOS Keychain, Linux libsecret, Windows Credential Vault — never plaintext files.
- ☁️ Works with the official cloud or self-hosted Standard Notes servers.
Features
| Tool | What it does |
|---|---|
notes_list / notes_search / notes_get |
Browse and search your notes (filter by tag with tag: "<uuid-or-title>") |
notes_create / notes_update / notes_delete |
Write notes (markdown, super, code, rich-text, task, spreadsheet, plain-text) |
notes_create_many |
Batch-create up to 50 notes in one sync push |
notes_stats |
Vault stats: counts, sizes, oldest/newest/largest note |
tags_list / tags_get / tags_create / tags_update / tags_delete |
Full tag CRUD |
tags_attach / tags_detach |
Link/unlink tags to notes |
sync |
Force a sync with the server |
notes_create and notes_update accept an optional tags: string[] (tag UUIDs) to link tags at write time.
Requirements
- Node.js ≥ 20
- A Standard Notes account on protocol 004 (default for any account created or upgraded since 2020)
- macOS, Linux, or Windows with a working OS keychain
Quickstart
1. Install
npm install -g mcp-standardnotes
Or run from a clone if you prefer:
git clone https://github.com/lozit/mcp-standardnotes.git
cd mcp-standardnotes
npm install && npm run build
2. Log in once
mcp-standardnotes-login # if installed globally
# or, from a clone:
npm run login
You'll be prompted for email and password. The password derives your master key in memory (Argon2id) and is never written to disk. An encrypted session is stored in your OS keychain; subsequent runs reuse it automatically. At the end of login, you're offered to wire the server into Claude Desktop in one step — accept it, restart Desktop, done.
3. Hook it up to Claude
Claude Desktop (macOS / Windows) — easiest path, run:
mcp-standardnotes-install
This writes the right entry (absolute Node + binary paths, your email from the keychain) into ~/Library/Application Support/Claude/claude_desktop_config.json (or %APPDATA%/Claude/claude_desktop_config.json on Windows), backing up any existing config first. Quit Claude Desktop fully (⌘Q) and relaunch.
Claude Code — let the claude CLI do it:
mcp-standardnotes-install code # prints the exact `claude mcp add` command
Or add to ~/.claude.json / .mcp.json manually:
{
"mcpServers": {
"mcp-standardnotes": {
"type": "stdio",
"command": "mcp-standardnotes",
"env": { "SN_EMAIL": "you@example.com" }
}
}
}
Then /mcp to reconnect.
Any other MCP client — run node dist/index.js with SN_EMAIL set in the environment. Transport is stdio.
Self-hosting Standard Notes? See docs/self-hosted.md for the docker-compose recipe and how to pin your TLS certificate.
Want a remote agent (Hermes on a VPS, self-hosted LangGraph, etc.) to use your vault? See docs/remote-agent-bridge.md for the full Cloudflare Tunnel + MCP Portals setup. Your master key stays on your Mac; the agent talks to a public HTTPS endpoint gated by a Cloudflare service token, and Portals handles automatic MCP tool discovery, multi-server bundling, and Access application generation.
Configuration
| Variable | Default | Description |
|---|---|---|
SN_EMAIL |
required | Your SN account email. Must match what you used with npm run login. |
SN_SERVER_URL |
https://api.standardnotes.com |
Sync server URL. Change for self-hosted instances. |
KEYCHAIN_SERVICE |
mcp-standardnotes |
Override the keychain service name (useful for multiple accounts). |
SN_CERT_FINGERPRINT |
unset | SHA-256 TLS cert pin for self-hosted servers (64 hex chars, colons optional). See docs/self-hosted.md. |
Security at a glance
- Password in RAM only during key derivation. Never logged, never stored.
- Session + master key hex → OS keychain only. Never plaintext files.
- stdio transport only. No HTTP port, ever.
- All logs go to stderr, routed through a redactor that masks passwords, keys, JWTs, and token-like strings.
- All tool inputs validated by zod.
npm auditHIGH/CRITICAL is a merge blocker in CI.- Only the protocol 004 framing is implemented locally; all cryptographic primitives come from
libsodium-wrappers-sumo.
Full threat model and deep-dive: docs/protocol-004.md. Security policy, vulnerability reporting, and dependency-advisory notes: SECURITY.md.
Troubleshooting
Common issues and fixes: docs/troubleshooting.md.
Logout
SN_EMAIL=you@example.com mcp-standardnotes-logout
# or, from a clone:
SN_EMAIL=you@example.com npm run logout
Roadmap
Upcoming work tracked in ROADMAP.md.
Contributing
Contributions welcome. See CONTRIBUTING.md for setup, tests, and PR checklist.
License
MIT — use it, fork it, ship it.
Credits
- Standard Notes for the encryption design and public API.
- Model Context Protocol and Anthropic for the MCP SDK.
- libsodium by Frank Denis, exposed via libsodium-wrappers-sumo.
Standard Notes MCP questions
How do I add Standard Notes MCP to Claude Code?
Run claude mcp add --env 'SN_EMAIL=<SN_EMAIL>' mcp-standardnotes -- npx -y mcp-standardnotes in your terminal. Add --scope user to make it available in every project.
How do I add Standard Notes MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is my data secure with this server?
Yes, all decryption happens locally using audited libsodium primitives, and your master key never leaves your machine.
Does this server open any network ports?
No, the server uses local stdio only and does not open any network ports.
Where is my session information stored?
Session information is stored securely in your OS keychain, such as macOS Keychain, Linux libsecret, or Windows Credential Vault.
Can I use this with a self-hosted Standard Notes instance?
Yes, it works with both the official cloud and self-hosted Standard Notes servers.