Skip to content
MCP server

Simplenote MCP

Let AI tools read your Simplenote notes, with optional write access, on any desktop OS

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers