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 referenceMCP 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 setupAPI keys
Create up to 10 scoped keys (ss_live_…) from Settings → API Keys for scripts, automations, and integrations. Shown once, revocable instantly.
Create a keyAutomation
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 itOpen 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 & exportOffline-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-firstQuickstart
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