Skip to content
Notes logoNotes

MCP Server

notes mcp starts a Model Context Protocol server over stdio. It speaks JSON-RPC on stdout and sends logging to stderr so the protocol stream stays clean.

{
  "mcp": {
    "notes": {
      "type": "local",
      "command": ["notes", "mcp"],
      "enabled": true
    }
  }
}

The server exposes note tools for reading, listing, writing, and deleting vault files. Reads include a SHA-256 revision that writes can use to reject stale content. See the generated MCP tool reference for tool parameters.

Successful writes and deletes send a desktop notification when notify-send is available. Notifications are best-effort, so the operation still succeeds when notify-send is missing or cannot reach a notification service.

Tools

Section titled “Tools”

Agent harnesses prefix tool names with the server key. With the server configured as notes, note_read appears as notes_note_read.

Resources

Section titled “Resources”
  • notes://context - repo-note context for the current repository.
  • notes://command/{name} - help text for a notes command.

Resources are a progressive enhancement; tools are the primary interface.