# Scratchpad

> Scratchpad is a paid MCP server for knowledge and memory. Let your assistant search, read and add to your Scratchpad notes, with a no-delete rule. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $8 a month
- **Platforms:** API, CLI, Web, iOS, Android, macOS, Windows
- **Website:** https://scratchpad.sh/ai/
- **Repository:** https://github.com/scratchpad-sh/mcp
- **MCP Registry name:** io.github.scratchpad-sh/scratchpad
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "scratchpad": {
      "url": "https://app.scratchpad.sh/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/scratchpad
