stashot-mcp

Stashot MCP

Connect the local screenshot library in the Stashot Mac app to Claude Code, Codex, Claude Desktop, Cursor, and other MCP clients.

Stashot captures screenshots, indexes their text with Apple Vision OCR, and lets your AI agent find the exact screen you saw earlier. Screenshots stay on your Mac; this package does not upload them or call a remote API.

Requirements

• Apple Silicon Mac
• macOS 13 Ventura or later
• Node.js 22.5 or later
• The free Stashot Mac app installed in /Applications or ~/Applications

This npm package is intentionally a small launcher. It runs the MCP server bundled inside the signed and notarized Stashot app, so the MCP server always matches the installed app version.

Install

Claude Code:

claude mcp add stashot -- npx -y stashot-mcp

Codex:

codex mcp add stashot -- npx -y stashot-mcp

Claude Desktop or Cursor:

{
  "mcpServers": {
    "stashot": {
      "command": "npx",
      "args": ["-y", "stashot-mcp"]
    }
  }
}

Check that the app can be found:

npx -y stashot-mcp --check

If the app is installed in a custom location, set STASHOT_APP_PATH to its .app path. Advanced users can point STASHOT_MCP_SERVER directly at a bundled mcp-server.js file.

Tools

• capture_screen — take a full-screen screenshot and save it to Stashot
• search_screenshots — search OCR text in the local screenshot history
• get_latest — return the newest screenshot
• get_screenshot_text — return OCR text for a screenshot ID

Privacy and security

Stashot stores screenshots, OCR text, settings, and its index locally. Connecting an MCP client allows that client to request screenshots and OCR text, so only add Stashot to AI clients you trust.

Support and feedback: stashot-feedback