home / mcp / ai scratchpad mcp server

AI Scratchpad MCP Server

MCP for logging interruptions

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "henrywork555-scratchpad": {
      "command": "python3",
      "args": [
        "/path/to/scratchpad/src/server.py"
      ]
    }
  }
}

You deploy a secure MCP server that maintains a single, global AI scratchpad on your Desktop. It tracks interruptions, ideas, tasks, and focus across projects, giving you quick access from any MCP-enabled client while enforcing strong security and lightweight operation.

How to use

Set up your MCP client to connect to the scratchpad server, then use its functions to log interruptions, update your current focus, queue items for later review, and manage completed or archived entries. You will interact with the scratchpad through your MCP client by referencing the server you configured and invoking the available actions from your workflow.

How to install

Prerequisites: Python 3.8+.

Prerequisites also include an MCP-compatible client (e.g., Claude Desktop or other MCP clients). These steps assume you are cloning the project to your local machine and running the server from source.

cd ~/Documents/GitHub/scratchpad
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
chmod +x src/server.py
python3 src/server.py & disown

Configuration and connection

{
  "mcpServers": {
    "scratchpad": {
      "command": "python3",
      "args": ["/path/to/scratchpad/src/server.py"]
    }
  }
}

Available tools

scratchpad_create

Create a new scratchpad file at the designated path. This initializes the central Markdown scratchpad on your Desktop.

scratchpad_get_path

Return the current scratchpad file path and verify that it exists.

scratchpad_read

Read the entire contents of the scratchpad file.

scratchpad_log_interruption

Log an interruption such as an idea, bug, feature request, question, or note. Include a note, optional type, and optional priority.

scratchpad_update_focus

Update the current focus or task description to reflect your present work.

scratchpad_add_to_review_later

Add an item to the To Review Later section for follow-up consideration.

scratchpad_mark_completed

Mark an item as completed. Moves it to Completed Today with a timestamp and removes it from Interruptions/Review Later.

scratchpad_archive_item

Archive or dismiss an item. Moves it to Archived / Dismissed and removes it from Interruptions/Review Later.