Simplenote MCP
Let AI tools read your Simplenote notes, with optional write access, on any desktop OS
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- today
Similar MCP servers
About Simplenote MCP
Simplenote MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
This server is published by Automattic and reads Simplenote data in two ways. On a Mac with the Simplenote desktop app synced, it can read the app's local Core Data store, which is fully offline, read-only and needs no login. Everywhere else it uses the Simperium HTTP API: a one-time setup command opens Simplenote's login page, shows a single-use code (valid five minutes) to paste back, and stores the token in a 0600 file.
It is read-only by default. Choosing write mode during setup exposes create, update, trash, restore and revert operations. A suggested first request after setup is to ask the assistant to list your tags.
It requires Node.js 22 or newer and works with Claude Desktop, Claude Code, Codex, Cursor, VS Code with Copilot, Zed, Cline and Windsurf. For headless runs the token can be passed as SIMPLENOTE_TOKEN with a config file naming the API source.
Install
Run in a terminal
claude mcp add simplenote-mcp -- npx -y @automattic/simplenote-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"simplenote-mcp": {
"command": "npx",
"args": [
"-y",
"@automattic/simplenote-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"simplenote-mcp": {
"command": "npx",
"args": [
"-y",
"@automattic/simplenote-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"simplenote-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/simplenote-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"simplenote-mcp": {
"command": "npx",
"args": [
"-y",
"@automattic/simplenote-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"simplenote-mcp": {
"command": "npx",
"args": [
"-y",
"@automattic/simplenote-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Offline Mac reading
- Reads the desktop app's local store with no auth.
- API access elsewhere
- Uses the Simperium HTTP API on Linux, Windows and Mac without the app.
- Opt-in write mode
- Create, update, trash, restore and revert tools appear only if enabled in setup.
- One-time code login
- Log in through the browser and paste a single-use code.
- Headless support
- Token can come from SIMPLENOTE_TOKEN for CI or servers.
- Wide client support
- Config examples for Claude, Codex, Cursor, VS Code, Zed, Cline and Windsurf.
Good for
- Ask an assistant to find a note by topic
- List and review your tags
- Summarise a set of notes before a meeting
- Draft and save a new note from chat (write mode)
- Restore a trashed note
Pricing
Open source
Simplenote MCP FAQ
Does it need an account?
Not on a Mac with the synced desktop app; elsewhere you need a Simplenote account.
Can it change my notes?
Only if you enable write mode during setup; it is read-only by default.
Where is the token kept?
In auth.json in the platform config directory, with file mode 0600.
What version of Node is required?
Node.js 22 or newer.
Is Simplenote MCP free?
Yes. Simplenote MCP is open source, so you can use and self-host it for free.
How do I add Simplenote MCP to Claude Code?
Run this command in your terminal: claude mcp add simplenote-mcp -- npx -y @automattic/simplenote-mcp
What are the best alternatives to Simplenote MCP?
The closest alternatives to Simplenote MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



