# mcp-standardnotes

Connects Claude Code to a Standard Notes vault for search, note editing, tags, and sync. Data access stays on the local MCP stdio process.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: lozit
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lozit/mcp-standardnotes
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-standardnotes

## What it does

mcp-standardnotes gives Claude Code tools for working with a Standard Notes vault. An agent can browse, search, read, create, edit, and delete notes, inspect vault statistics, run a sync, and manage tags. Write operations cover formats such as markdown, code, rich text, tasks, spreadsheets, and plain text.

The server uses local stdio transport and keeps the session data in the operating system keychain. The password is used in memory during key derivation, while the vault master key remains on the machine. A self-hosted Standard Notes server can be selected with environment settings, including an optional TLS certificate fingerprint.

You need Node.js ≥ 20, a Standard Notes account on protocol 004, and a working keychain on macOS, Linux, or Windows. Without Node.js ≥ 20, the server will not run.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SN_EMAIL`, `SN_SERVER_URL`, `SN_CERT_FINGERPRINT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SN_EMAIL=<SN_EMAIL> --env SN_SERVER_URL=<SN_SERVER_URL> --env SN_CERT_FINGERPRINT=<SN_CERT_FINGERPRINT> --transport stdio mcp-standardnotes -- npx -y mcp-standardnotes
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-standardnotes --env SN_EMAIL=<SN_EMAIL> --env SN_SERVER_URL=<SN_SERVER_URL> --env SN_CERT_FINGERPRINT=<SN_CERT_FINGERPRINT> -- npx -y mcp-standardnotes
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-standardnotes": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-standardnotes"
            ],
            "env": {
                "SN_EMAIL": "<SN_EMAIL>",
                "SN_SERVER_URL": "<SN_SERVER_URL>",
                "SN_CERT_FINGERPRINT": "<SN_CERT_FINGERPRINT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-standardnotes": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-standardnotes"
            ],
            "env": {
                "SN_EMAIL": "<SN_EMAIL>",
                "SN_SERVER_URL": "<SN_SERVER_URL>",
                "SN_CERT_FINGERPRINT": "<SN_CERT_FINGERPRINT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SN_EMAIL=<SN_EMAIL> -e SN_SERVER_URL=<SN_SERVER_URL> -e SN_CERT_FINGERPRINT=<SN_CERT_FINGERPRINT> mcp-standardnotes npx -y mcp-standardnotes
```
Replace <…> with your own values

## When to use it
- search a vault by note content or tag
- draft a new Standard Notes entry from an agent request
- edit or remove an existing note
- inspect vault counts and sync the account

## Example prompts
- Search my Standard Notes vault for notes about the release and summarize the relevant entries.
- Create a note with the conclusions from this task and attach the tag UUID `...`.
- Show the vault statistics and open the oldest note.

## Similar
- [openclaw-backup](https://affpapa.org/en/nevibecode/skills/openclaw-backup.md) — skill · 3100 installs
- [Compartment](https://affpapa.org/en/nevibecode/mcp/compartment.md) — MCP server · ★ 576
- [vnsh](https://affpapa.org/en/nevibecode/mcp/vnsh.md) — MCP server · ★ 158
- [KeibiDrop](https://affpapa.org/en/nevibecode/mcp/keibidrop.md) — MCP server · ★ 69
- [openfuse-mcp](https://affpapa.org/en/nevibecode/mcp/openfuse-mcp.md) — MCP server · ★ 18
- [aispace](https://affpapa.org/en/nevibecode/mcp/aispace.md) — MCP server · ★ 13

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md