# Simplenote MCP

> Simplenote MCP is an open-source MCP server for productivity. Let AI tools read your Simplenote notes, with optional write access, on any desktop OS. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/automattic/simplenote-mcp
- **MCP Registry name:** io.github.Automattic/simplenote-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add simplenote-mcp -- npx -y @automattic/simplenote-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "simplenote-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/simplenote-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "simplenote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/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.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/simplenote-mcp
