MCP Server — StashSync.app

Overview

StashSync exposes an MCP (Model Context Protocol) server at https://api.stashsync.app/mcp. It uses the Streamable HTTP transport and is stateless — each request is independent, with no persistent session.

The MCP server accepts API keys only (ss_live_...). See API & API Keys to create one.

Available tools

Tool	Description
`search`	Full-text search across notes and bookmarks
`list_notes`	List notes with optional filters
`get_note`	Get a single note by ID
`create_note`	Create a new note (`content` accepts Markdown)
`update_note`	Update title, content, stash, tags, or pinned state
`trash_note`	Move a note to trash
`restore_note`	Restore a trashed note
`list_bookmarks`	List bookmarks with optional filters
`get_bookmark`	Get a single bookmark by ID
`add_bookmark`	Save a new bookmark
`update_bookmark`	Update a bookmark
`trash_bookmark`	Move a bookmark to trash
`restore_bookmark`	Restore a trashed bookmark
`list_stashes`	List all stashes
`create_stash`	Create a new stash (name, optional color)
`update_stash`	Update a stash's name or color
`trash_stash`	Move a stash to trash (items inside are not deleted)
`restore_stash`	Restore a trashed stash
`list_stash_items`	List notes and bookmarks inside a stash
`list_tags`	List all tags
`create_tag`	Create a new tag (name, optional color)
`update_tag`	Update a tag's name or color
`trash_tag`	Move a tag to trash (tagged items are not deleted)
`restore_tag`	Restore a trashed tag
`list_tag_items`	List notes and bookmarks that have a given tag

Setup: Claude Desktop

Claude Desktop does not support Streamable HTTP natively. Use mcp-remote as a stdio bridge — it requires Node.js to be installed.

Add the following to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stashsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.stashsync.app/mcp",
        "--header",
        "Authorization: Bearer ss_live_YOUR_KEY"
      ]
    }
  }
}

Replace ss_live_YOUR_KEY with your actual API key, then restart Claude Desktop.

Setup: Cursor

Cursor supports Streamable HTTP directly. Add to your Cursor MCP config:

{
  "mcpServers": {
    "stashsync": {
      "type": "http",
      "url": "https://api.stashsync.app/mcp",
      "headers": {
        "Authorization": "Bearer ss_live_YOUR_KEY"
      }
    }
  }
}

Setup: Other MCP clients

Any MCP client that supports Streamable HTTP can connect directly:

Endpoint: https://api.stashsync.app/mcp
Auth header: Authorization: Bearer ss_live_YOUR_KEY

For clients that only support stdio, use mcp-remote as shown in the Claude Desktop setup above.

Usage examples

Once connected, you can talk to your AI assistant naturally:

"Save a note with today's meeting summary"
"Search my stash for anything about Cloudflare Workers"
"Add this URL to my bookmarks with the tag 'reading-list'"
"Show me all pinned notes in my Research stash"
"Create a stash called 'Side Projects'"

The MCP server operates on the same data as the StashSync app. Changes made via MCP are reflected in the app immediately, and vice versa.

Authentication

The MCP server requires an API key — Clerk session tokens are not accepted. You can't use an API key to create another API key, so key management must be done through the app.

See API & API Keys for instructions on creating and revoking keys.