English Français العربية

Scratchpad

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

متغيرات البيئة

  • SCRATCHPAD_TOKEN إلزامي سري API token from Settings, API tokens
  • SCRATCHPAD_URL Install to talk to. Defaults to https://app.scratchpad.sh

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Scratchpad؟

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

كيف أثبّت Scratchpad؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http scratchpad 'https://app.scratchpad.sh/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Scratchpad إلى مفتاح API؟

نعم. يتطلب SCRATCHPAD_TOKEN، وتضبطها في إعداداته.

هل Scratchpad مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Scratchpad؟

ينشره scratchpad-sh. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.