Skip to content
MCP server

Scratchpad

Let your assistant search, read and add to your Scratchpad notes, with a no-delete rule

Pricing
Paid
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.0.0
Listing updated
2 days ago

About Scratchpad

Scratchpad is a paid MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

Scratchpad's server is about 2,000 lines of TypeScript with no database or on-disk state, and each tool makes one or two calls to Scratchpad's API. Remote use signs in through OAuth, which the README says is the only option on a phone; a local stdio package uses an API token instead.

The safety design is unusual. No tool can delete a note. Editing is two steps: propose_edit writes nothing and returns a diff with an id, and apply_edit takes only that id, so text cannot change after you see the diff. If the note changed meanwhile the edit is refused, history keeps earlier versions, and password-locked notes stay invisible. The site adds three permission levels per connected app: Capture, Read and Full.

Tools cover notes, attachments (it can read PDFs and images), folders, organisation and version history, all prefixed scratchpad_. The assistant plan includes 500 messages a month.

Install

Run in a terminal

claude mcp add --transport http scratchpad https://app.scratchpad.sh/api/mcp

Add to Settings → Connectors → Add custom connector

https://app.scratchpad.sh/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scratchpad": {
      "url": "https://app.scratchpad.sh/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "scratchpad": {
      "type": "http",
      "url": "https://app.scratchpad.sh/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "scratchpad": {
      "serverUrl": "https://app.scratchpad.sh/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "scratchpad": {
      "type": "http",
      "url": "https://app.scratchpad.sh/api/mcp"
    }
  }
}

Configuration

  • SCRATCHPAD_TOKENAPI token from Settings, API tokensRequired
  • SCRATCHPAD_URLInstall to talk to. Defaults to https://app.scratchpad.sh

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

search_notes
Searches notes.
read_note
Reads a note.
list_notes
Lists notes.
list_folders
Lists folders.
search_attachment
Searches within attachments.
read_attachment
Reads an attachment.
create_note
Creates a note.
append_to_note
Appends text to a note.
propose_edit
Proposes an edit and returns a diff and id.
apply_edit
Applies a proposed edit by id.
move_note
Moves a note.
rename_note
Renames a note.
archive_note
Archives a note.
pin_note
Pins a note.
duplicate_note
Duplicates a note.
create_folder
Creates a folder.
rename_folder
Renames a folder.
move_folder
Moves a folder.
delete_folder
Deletes a folder.
list_versions
Lists note versions.
read_version
Reads a note version.
restore_version
Restores a version.

What it does

Search and read
search_notes, read_note, list_notes and list_folders.
Two-step editing
propose_edit shows a diff; apply_edit applies it by id.
No delete tool
Assistants cannot delete notes or move them to Trash.
Attachment reading
search_attachment and read_attachment cover PDFs and images.
Version history
list_versions, read_version and restore_version undo edits.
Three permission levels
Capture, Read or Full per connected app.

Good for

  • Ask Claude what you wrote about a trip
  • Append meeting notes to an existing note
  • Review and accept an AI-proposed rewrite
  • Organise notes into folders by conversation
  • Restore an earlier version of a note

Pricing

Paid, from $8 a month

Subscription includes 500 assistant messages/month and a 30-day money-back guarantee; bring-your-own-key option US$8/month

Prices change. Check scratchpad.sh before you buy.

Scratchpad FAQ

Can an assistant delete my notes?

No. There is no tool that deletes a note or moves it to Trash.

How do I connect on a phone?

Use the remote OAuth address https://app.scratchpad.sh/api/mcp; stdio does not work there.

Are locked notes visible?

No. Password-locked notes stay invisible to tokens and connectors.

Is my data used for AI training?

The site says it never uses your notes to train AI models.

Is Scratchpad free?

No. Scratchpad is a paid product. Paid plans start at $8 a month.

How do I add Scratchpad to Claude Code?

Run this command in your terminal: claude mcp add --transport http scratchpad https://app.scratchpad.sh/api/mcp

What are the best alternatives to Scratchpad?

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

Alternatives to Scratchpad

  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