Allows AI clients to search, read, write, and organize notes within the Scratchpad application.
Also known as scratchpad-sh/mcp, mcp, @scratchpadsh/mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 7, 2026
- License
- MIT
What is Scratchpad MCP?
Scratchpad allows AI clients to search, read, write, and organize notes within the Scratchpad application.
Summary generated from the project's README
About Scratchpad MCP server
Scratchpad provides an interface for AI clients like Claude, Cursor, and Codex to interact with your existing notes. It allows an assistant to search, read, write, and organize information stored within the Scratchpad application. Developers can connect via a remote HTTPS endpoint using OAuth, which is the preferred method for mobile use, or through a local stdio setup using an API token.
The server is designed with safety in mind, ensuring that an AI cannot accidentally delete your data. There is no tool provided for deleting notes, and all editing follows a two-step process using propose_edit and apply_edit to prevent overwriting changes. The system also supports version history through list_versions and restore_version, allowing you to revert to previous states. Password-protected notes remain hidden from the AI, and tools are annotated to help clients manage write permissions safely.
Written from the project's README. Every use case is checked against a quote from it.
How to install Scratchpad MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Scratchpad MCP in Claude Code
$ claude mcp add --env 'SCRATCHPAD_TOKEN=<YOUR_SCRATCHPAD_TOKEN>' mcp -- npx -y @scratchpadsh/mcpInstall Scratchpad MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@scratchpadsh/mcp"
],
"env": {
"SCRATCHPAD_TOKEN": "<YOUR_SCRATCHPAD_TOKEN>"
}
}
}
}Install Scratchpad MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@scratchpadsh/mcp"
],
"env": {
"SCRATCHPAD_TOKEN": "<YOUR_SCRATCHPAD_TOKEN>"
}
}
}
}Install Scratchpad MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@scratchpadsh/mcp"],"env":{"SCRATCHPAD_TOKEN":"<YOUR_SCRATCHPAD_TOKEN>"}}'Install Scratchpad MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@scratchpadsh/mcp"
],
"env": {
"SCRATCHPAD_TOKEN": "<YOUR_SCRATCHPAD_TOKEN>"
}
}
}
}Install Scratchpad MCP in Codex
$ codex mcp add mcp --env 'SCRATCHPAD_TOKEN=<YOUR_SCRATCHPAD_TOKEN>' -- npx -y @scratchpadsh/mcpInstall Scratchpad MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@scratchpadsh/mcp"] [mcp_servers.mcp.env] SCRATCHPAD_TOKEN = "<YOUR_SCRATCHPAD_TOKEN>"
Install Scratchpad MCP in Gemini CLI
$ gemini mcp add -s user -e 'SCRATCHPAD_TOKEN=<YOUR_SCRATCHPAD_TOKEN>' mcp npx -- -y @scratchpadsh/mcpInstall Scratchpad MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@scratchpadsh/mcp"
],
"env": {
"SCRATCHPAD_TOKEN": "<YOUR_SCRATCHPAD_TOKEN>"
}
}
}
}Configuration
SCRATCHPAD_TOKENRequiredSecretAPI token from Settings, API tokens
SCRATCHPAD_URLInstall to talk to. Defaults to https://app.scratchpad.sh
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablescratchpad-sh/mcp is public and reachablegithub.com/scratchpad-sh/mcp ↗Pass
- Package names this repository as its source@scratchpadsh/mcp names scratchpad-sh/mcp as sourcenpmjs.com/package/@scratchpadsh/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/scratchpad-sh/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @scratchpadsh/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubScratchpad 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
Remote (recommended)
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_TOKEN |
required | read can search and read. full is needed for anything that writes. |
SCRATCHPAD_URL |
optional | Defaults to https://app.scratchpad.sh. |
Tools
| Area | Tools |
|---|---|
| Find and read | search_notes, read_note, list_notes, list_folders |
| Attachments | search_attachment, read_attachment |
| Write | create_note, append_to_note, propose_edit, apply_edit |
| Organize | move_note, rename_note, archive_note, pin_note, duplicate_note |
| Folders | create_folder, rename_folder, move_folder, delete_folder |
| History | list_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_editwrites nothing: it returns a diff and an id.apply_edittakes 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_versionkeeps 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 MCP questions
How do I add Scratchpad MCP to Claude Code?
Run claude mcp add --env 'SCRATCHPAD_TOKEN=<YOUR_SCRATCHPAD_TOKEN>' mcp -- npx -y @scratchpadsh/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Scratchpad MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can the AI delete my notes?
No, there is no tool provided that allows for the deletion of a note.
How does the editing process work to prevent errors?
Editing is a two-step process involving a proposal and an application to ensure the text does not change unexpectedly.
Are password-protected notes accessible to the AI?
No, password-locked notes remain invisible to both tokens and connectors.