English Français العربية

Scratchpad

Official registry Search and web

Search, read, write, and organize your Scratchpad notes from any MCP client.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http scratchpad 'https://app.scratchpad.sh/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "scratchpad": {
            "type": "http",
            "url": "https://app.scratchpad.sh/api/mcp"
        }
    }
}
NPM package @scratchpadsh/mcp
Claude Code 
claude mcp add scratchpad -e 'SCRATCHPAD_TOKEN=<your scratchpad_token>' -e 'SCRATCHPAD_URL=<SCRATCHPAD_URL>' -- npx -y @scratchpadsh/mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "scratchpad": {
            "command": "npx",
            "args": [
                "-y",
                "@scratchpadsh/mcp@1.0.0"
            ],
            "env": {
                "SCRATCHPAD_TOKEN": "<your scratchpad_token>",
                "SCRATCHPAD_URL": "<SCRATCHPAD_URL>"
            }
        }
    }
}

Environment variables

  • SCRATCHPAD_TOKEN required secret API token from Settings, API tokens
  • SCRATCHPAD_URL Install to talk to. Defaults to https://app.scratchpad.sh

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Scratchpad MCP server
  2. Two ways to connect
  3. Tools
  4. Built so a model cannot quietly wreck your notes
  5. Develop
  6. License

Scratchpad MCP server

Give your AI your notes. An MCP server for Scratchpad, so Claude, Cursor, Codex, and any other MCP client can search, read, write, and organize the notes you already keep.

It is small on purpose: about 2,000 lines of TypeScript, no database, and no state on disk. Every tool is one or two calls to Scratchpad's HTTPS API, so you can read the whole thing in an evening and know exactly what your assistant can do.

Two ways to connect

No install. Point your client at the hosted server and sign in with OAuth. This is the only way that works on a phone.

https://app.scratchpad.sh/api/mcp

Claude Code:

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

Cursor, in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scratchpad": { "url": "https://app.scratchpad.sh/api/mcp" }
  }
}
Local (stdio)

For a client that only speaks stdio, or if you would rather hold an API token than an OAuth session. Create a token in Scratchpad under Settings, API tokens.

{
  "mcpServers": {
    "scratchpad": {
      "command": "npx",
      "args": ["-y", "@scratchpadsh/mcp"],
      "env": { "SCRATCHPAD_TOKEN": "scr_your_token" }
    }
  }
}

Check the token before wiring it up:

SCRATCHPAD_TOKEN=scr_your_token npx -y @scratchpadsh/mcp --check
Variable
SCRATCHPAD_TOKENrequiredread can search and read. full is needed for anything that writes.
SCRATCHPAD_URLoptionalDefaults to https://app.scratchpad.sh.

Tools

AreaTools
Find and readsearch_notes, read_note, list_notes, list_folders
Attachmentssearch_attachment, read_attachment
Writecreate_note, append_to_note, propose_edit, apply_edit
Organizemove_note, rename_note, archive_note, pin_note, duplicate_note
Folderscreate_folder, rename_folder, move_folder, delete_folder
Historylist_versions, read_version, restore_version

Every name carries a scratchpad_ prefix, so the tools sit cleanly beside other servers in one session.

Built so a model cannot quietly wreck your notes

  • There is no tool that deletes a note. That stays a job for you.
  • Editing is two steps. propose_edit writes nothing: it returns a diff and an id. apply_edit takes that id and no content, so the text cannot change between showing you the diff and writing it.
  • Edits check the base. If the note changed since the proposal, the edit is refused rather than overwriting what you typed.
  • Every edit is reversible. History keeps earlier versions, and restore_version keeps the current one first.
  • Password-locked notes stay invisible, to tokens and connectors alike.
  • Tools are annotated, so a client can run reads freely and stop to show you each write.

Develop

npm install
npm test

License

MIT. See LICENSE.

Made by Scratchpad, the notes app your AI can actually read. More at scratchpad.sh/ai.

Frequently asked questions

What is Scratchpad?

Search, read, write, and organize your Scratchpad notes from any MCP client.

How do I install Scratchpad?

It runs as a remote server. In Claude Code: claude mcp add --transport http scratchpad 'https://app.scratchpad.sh/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Scratchpad need an API key?

Yes. It expects SCRATCHPAD_TOKEN, which you set in its configuration.

Is Scratchpad open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Scratchpad?

It is published by scratchpad-sh. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.