For developers

Build on your notes, bookmarks & files

StashSync ships with a REST API, an MCP server for AI assistants, scoped API keys, and full Markdown export — all on an offline-first workspace. Automate capture, pipe in research, or let Claude work directly with your library.

A developer-friendly workspace

REST API

Read and write notes, bookmarks, stashes, and tags over a clean REST API at api.stashsync.app/v1. Bearer-token auth, JSON everywhere, 120 requests/min per key.

API reference

MCP server for AI

A hosted Model Context Protocol server at api.stashsync.app/mcp lets Claude and other AI assistants read, search, and write your library directly. Streamable HTTP, stateless, API-key auth.

MCP setup

API keys

Create up to 10 scoped keys (ss_live_…) from Settings → API Keys for scripts, automations, and integrations. Shown once, revocable instantly.

Create a key

Automation

Wire StashSync into n8n, Zapier, or your own scripts. Auto-capture links, sync notes from other tools, or pipe research into Collections — no glue server required.

Automate it

Open data & export

Export notes as Markdown and bookmarks as standard Netscape HTML, or take a full JSON backup. Import Markdown (.md/.markdown/.txt) too. Your data is never trapped.

Import & export

Offline-first by design

Everything is stored locally (IndexedDB) and synced with CRDTs, so your integrations work against a workspace that keeps running even when the network doesn't.

Why local-first

Quickstart

Create an API key in Settings → API Keys, then call the API or point your MCP client at it.

List your notes

curl https://api.stashsync.app/v1/notes \
  -H "Authorization: Bearer ss_live_your_key_here"

Connect an MCP client (e.g. Claude)

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

Full details in the API reference and MCP guide.

Developer FAQ

Does StashSync have an API?

Yes. The REST API at https://api.stashsync.app/v1 exposes your notes, bookmarks, stashes, and tags. Authenticate with a Bearer API key (ss_live_…) created in Settings → API Keys. The rate limit is 120 requests per minute per key.

What is the StashSync MCP server?

It's a hosted Model Context Protocol server at https://api.stashsync.app/mcp that lets AI assistants like Claude read, search, and write your StashSync library. It uses the Streamable HTTP transport, is stateless, and authenticates with an API key.

How do I get an API key?

Open Settings → API Keys in the app, click Create API key, and copy the ss_live_… value — it's shown only once. You can hold up to 10 active keys and revoke any of them instantly.

Can I export my data?

Yes. Export individual notes as Markdown, all bookmarks as Netscape HTML (importable into any browser), or a full JSON backup. You can also import Markdown files and browser bookmark exports. Nothing is locked in.

Is the API available on the free plan?

Start free and try it — see the pricing on the homepage for current plan limits. Your data stays yours either way, with full Markdown and bookmark export.

Start building

Create a free account, generate an API key, and put your notes, bookmarks, and files to work.

Create a free account