automattic avatar

Simplenote Mcp

automattic/simplenote-mcpOfficial

Connects Claude and other MCP clients to your Simplenote account with read access by default and optional write tools (create, update, trash, restore). On macOS it can read directly from the Simplenote desktop app's local Core Data store with zero auth, fully offline. On Linux, Windows, or macOS without the app, it authenticates once via magic link and talks to the Simperium HTTP API. Setup asks whether to enable write mode, which gates the mutation tools behind explicit opt-in. Useful when you keep research notes, drafts, or reference material in Simplenote and want Claude to search or update them without switching apps.

GitHub stars
33
tools
11
transport
STDIO
last updated
Nov 6, 2026

Tools

11 tools

Public tool metadata for what this MCP can expose to an agent.

list_tagsList all tags in your Simplenote account.

List all tags in your Simplenote account.

No parameter schema in public metadata yet.

list_notesList recent notes, optionally filtered by tag.

List recent notes, optionally filtered by tag.

No parameter schema in public metadata yet.

search_notesSearch notes by content, title, or tags.

Search notes by content, title, or tags.

No parameter schema in public metadata yet.

get_noteGet the full content of a specific note.

Get the full content of a specific note.

No parameter schema in public metadata yet.

create_noteCreate a new note. Write tool — requires write mode enabled in `simplenote-mcp setup` and the Simperium API provider.

Create a new note. Write tool — requires write mode enabled in `simplenote-mcp setup` and the Simperium API provider.

No parameter schema in public metadata yet.

update_noteUpdate an existing note. Write tool — requires write mode and the Simperium API provider.

Update an existing note. Write tool — requires write mode and the Simperium API provider.

No parameter schema in public metadata yet.

trash_noteSoft-delete a note (move to Simplenote trash). The note stays in the bucket and can be restored from any Simplenote client. Write tool — requires write mode and the Simperium API provider.

Soft-delete a note (move to Simplenote trash). The note stays in the bucket and can be restored from any Simplenote client. Write tool — requires write mode and the Simperium API provider.

No parameter schema in public metadata yet.

restore_noteRestore a previously-trashed note so it reappears in active lists. Inverse of `trash_note`. Write tool — requires write mode and the Simperium API provider.

Restore a previously-trashed note so it reappears in active lists. Inverse of `trash_note`. Write tool — requires write mode and the Simperium API provider.

No parameter schema in public metadata yet.

get_note_historyList recent versions of a note with short content previews. Read-only operation; requires the Simperium API provider with write mode enabled in the current server.

List recent versions of a note with short content previews. Read-only operation; requires the Simperium API provider with write mode enabled in the current server.

No parameter schema in public metadata yet.

get_note_versionGet the full content of a specific historical version of a note. Read-only operation; requires the Simperium API provider with write mode enabled in the current server. Use to preview content before calling `revert_note`.

Get the full content of a specific historical version of a note. Read-only operation; requires the Simperium API provider with write mode enabled in the current server. Use to preview content before calling `revert_note`.

No parameter schema in public metadata yet.

revert_noteRestore a note to a prior version. Counts toward the write-rate budget. Bypasses the trashed-note guard — reverting to a non-trashed version will un-trash; reverting to a trashed version will re-trash.

Restore a note to a prior version. Counts toward the write-rate budget. Bypasses the trashed-note guard — reverting to a non-trashed version will un-trash; reverting to a trashed version will re-trash.

No parameter schema in public metadata yet.

Sponsors

Readme

simplenote-mcp

An MCP (Model Context Protocol) server that gives any MCP-compatible AI tool access to your Simplenote data — read by default, with opt-in write tools (create, update, trash, restore, revert) when you run simplenote-mcp setup with write mode enabled.

On macOS, it can read directly from the local Simplenote desktop app's Core Data store — fully offline, no auth. On Linux and Windows (and on macOS without the desktop app), it talks to the Simperium HTTP API after a one-time simplenote-mcp setup.

Works with Claude Desktop, Claude Code, Cursor, VS Code (Copilot), Zed, Cline, Windsurf, and anything else that speaks MCP.

Quick start

Run setup once:

npx -y @automattic/simplenote-mcp setup

On macOS with the Simplenote desktop app installed and synced, setup detects the local database and asks whether to use it. Accepting that option is fully offline and read-only. On Linux, Windows, or macOS without the desktop app, setup opens Simplenote's login page in your browser. After you log in, the page shows a one-time code; paste it into setup, then choose whether to enable write mode.


View the full README on GitHub

Details

Repository
github.com/automattic/simplenote-mcp
Package
@automattic/simplenote-mcp
Transport
STDIO
Registry
MCP registry, active