auspy/supasidebar-mcp

Give your AI assistant local access to your current open tabs, saved bookmarks, and recently opened links across every browser on your Mac. Nothing leaves your device.
Works with Claude Code, Claude Desktop, Cursor, Codex, VS Code Copilot, and any MCP-compatible client.
> **New to SupaSidebar?** SupaSidebar is a free macOS app that brings an Arc-style sidebar to every browser - one place for your tabs, bookmarks, files, folders, and apps. This MCP server is the bridge that lets an AI agent drive it. You'll need the app installed and running (it's free to start), because every tool call runs locally against it.
**Docs**: docs.supasidebar.com/features/mcp
What you can do with it
Once it's connected, you talk to your AI assistant in plain language and it uses the tools below to act on your behalf. A few things people ask for:
**Tame open tabs**
> "What do I have open right now? Save everything about the Q3 launch into a new 'Launch' space and close the noise."
*(uses get_live_tabs, create_space, add_link)*
**Find that thing you saved**
> "Find the pricing page I bookmarked last week - I think it had 'billing' in the notes."
*(uses search, list_recent)*
**Organize without clicking**
> "My unfiled links are a mess. Group them into folders by topic and move them there."
*(uses list_links, create_folder, move_link)*
**Open things in the right place**
> "Open my three design links in Chrome's Work profile."
*(uses list_browser_profiles, open_link)*
**Automate routing once, forever**
> "From now on, always open figma.com links in my browser's Design profile, and save any URL from my company domain into the 'Work' space."
*(uses add_atc_rule)*
**Recall your day**
> "What did I open yesterday afternoon?"
*(uses list_recent with date filters)*
All 36 tools are listed further down. Nothing leaves your Mac - see Trust & Privacy.
How it works
The MCP server is a thin bridge. It translates AI tool calls into local HTTP requests to the SupaSidebar app running on your Mac. Your data never leaves your machine.
Trust & Privacy
1. **Zero network requests** - communicates only with 127.0.0.1 (localhost). The host is hardcoded and cannot be changed.
2. **Zero data storage** - no files written, no databases, no caches.
3. **Zero telemetry** - no analytics, no tracking, no usage reporting.
4. **One runtime dependency** - @modelcontextprotocol/sdk (the protocol library).
Prerequisites
New to SupaSidebar? Do these three steps in order. If you already run the app, skip to Setup.
1. Install and launch the SupaSidebar app
The MCP server is only a bridge - it needs the SupaSidebar Mac app running to do anything. Install it with Homebrew or a direct download:
- **With Homebrew** (one command, and brew upgrade keeps it current):
Cask on formulae.brew.sh
- **Direct download** - go to **supasidebar.com**, click **Download For Free**, then drag **SupaSidebar** into your **Applications** folder.
Then **launch the app and leave it running** - the server talks to its local bridge API at 127.0.0.1:9847, which is only available while the app is open.
**Requirements:** macOS 14 (Sonoma) or later. The download is free.
**Version compatibility:** supasidebar-mcp@0.2.3 requires **SupaSidebar app 0.17.2 or later**. Older app versions are missing bridge endpoints used by some of the 36 tools. Check your version in **SupaSidebar → About**, and update via **SupaSidebar → Check for Updates** if needed.
2. Grant macOS permissions
SupaSidebar needs two macOS permissions for the MCP tools to work end-to-end (especially anything touching browsers, tabs, or windows). Open the relevant pane in **System Settings → Privacy & Security**:
- **Accessibility** - required for window/sidebar control, global shortcuts, and tab management.
Open: Privacy & Security → Accessibility
- **Automation** - required for browser integration (read live tabs, open URLs in specific browsers/profiles via AppleScript).