English Français العربية

Scratchpad

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http scratchpad 'https://app.scratchpad.sh/api/mcp'
Configuration JSON (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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que Scratchpad ?

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

Comment installer Scratchpad ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http scratchpad 'https://app.scratchpad.sh/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Scratchpad ?

Oui. Il attend SCRATCHPAD_TOKEN, à renseigner dans sa configuration.

Scratchpad est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Scratchpad ?

Il est publié par scratchpad-sh. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.