stash-mcp-server

MCP server for Stash — a self-hosted read-it-later app on Cloudflare Workers.

Lets AI assistants (Claude, etc.) save, search, tag, and manage your bookmarks via the Model Context Protocol.

Setup

1. Get an API key

Open your Stash instance → Settings → API Keys → create a key.

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "stash": {
      "command": "npx",
      "args": ["-y", "stash-mcp-server"],
      "env": {
        "STASH_URL": "https://your-stash-instance.workers.dev",
        "STASH_API_KEY": "stash_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop — the stash tools will appear automatically.

Tools

| Tool | Description | |---|---| | save_bookmark | Save a URL with title; returns bookmark ID and AI-generated tags | | delete_bookmark | Delete a bookmark by ID | | add_tag | Add a tag to a bookmark | | remove_tag | Remove a tag from a bookmark | | list_tags | List all tags with bookmark counts | | search_bookmarks | Search by keyword (fuzzy), meaning (semantic), or tag | | suggest_titles | Autocomplete bookmark titles |

Environment variables

| Variable | Required | Description | |---|---|---| | STASH_URL | Yes | Base URL of your Stash instance | | STASH_API_KEY | Yes | API key (stash_…) from Stash settings |