Skip to content
MCP server

Pinto Notes

Let ChatGPT, Claude and Codex search and edit your Pinto Notes, with undo

Pricing
Open source
Platforms
API, macOS, iOS
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Pinto Notes

Pinto Notes is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Pinto Notes is a notes app for iPhone and Mac, and its built-in server treats notes like files in a folder. Each note is a markdown file with a path such as Work/Acme.md, checklists are task lines and tables are markdown tables. An edit is an exact search-and-replace that changes one line and leaves the rest alone.

Access needs a Pinto Notes account and the owner's approval. OAuth 2.1 clients approve through a short flow that shows a two-digit number the person types into the Mac app. Claude Code and Codex can instead use a token created in Settings. Every connection is listed and can be disconnected, and tool calls run as that person with row-level security.

Notes are encrypted on the person's devices. An approved connection gets a copy of the key locked to its token, and the server decrypts only what a request needs in memory. Each edit keeps the previous version with its author, with history and restore tools, and deleted notes stay recoverable for 30 days.

Install

Run in a terminal

claude mcp add --transport http pinto-notes https://mcp.pintonotes.com

Add to Settings → Connectors → Add custom connector

https://mcp.pintonotes.com
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pinto-notes": {
      "url": "https://mcp.pintonotes.com"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pinto-notes": {
      "type": "http",
      "url": "https://mcp.pintonotes.com"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pinto-notes": {
      "serverUrl": "https://mcp.pintonotes.com"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pinto-notes": {
      "type": "http",
      "url": "https://mcp.pintonotes.com"
    }
  }
}

What it does

Notes as files
Markdown paths, checklists and tables an agent can navigate.
Targeted edits
Exact search-and-replace changes one line at a time.
Version history
Every change keeps the previous version and who made it.
Visible AI changes
The app tints and labels AI edits, with undo.
Per-connection approval
Each client is approved by the owner and can be disconnected.
Note-based apps
A note can become a tracker or budget while the text stays underneath.

Good for

  • Find a travel note and add a day to the plan
  • Tick off a checklist from Claude Code
  • Undo an AI edit from the app
  • Share one notebook between ChatGPT and Claude

Pricing

Open source

Free and open source (MIT) per the README

Prices change. Check pintonotes.com before you buy.

Pinto Notes FAQ

Is the server open source?

The README says Pinto Notes is free and open source under the MIT licence.

How does sign-in work?

OAuth 2.1 with PKCE for ChatGPT and Claude, or a pane_ token for Claude Code and Codex.

Can an AI read locked notes?

No. Locked notes stay out of reach because their key comes from the notes password.

How long are deleted notes kept?

Deleted notes go to Recently Deleted for 30 days.

Is Pinto Notes free?

Yes. Pinto Notes is open source, so you can use and self-host it for free.

How do I add Pinto Notes to Claude Code?

Run this command in your terminal: claude mcp add --transport http pinto-notes https://mcp.pintonotes.com

What are the best alternatives to Pinto Notes?

The closest alternatives to Pinto Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Pinto Notes

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools