Get a complete guide to SupaSidebar's MCP capabilities. Shows all available tools, what they do, common user requests mapped to tool calls, setting categories, and feature presets. Call this first when you're unsure which tool to use.

List all spaces in SupaSidebar. Spaces are top-level collections that organize your links.

List links in a specific space or folder. Returns link names, URLs, tags, and notes.

Search across all links in SupaSidebar by name, URL, notes, or tags. Uses fuzzy matching.

List folders in a space. Folders organize links hierarchically within a space.

List all tags used across your links, sorted by usage count.

Get currently open browser tabs. Can filter by browser (Arc, Chrome, Safari, Firefox, Edge, Brave, etc).

List recently opened links, ordered by most recent first. If you don't see what the user wants in the first call, do NOT give up — increase limit (the default of 50 is small relative to a power user's history), page back with offset, or narrow with day/since/until. To find what someone opened on a specific day, prefer day="YYYY-MM-DD" (or "today"/"yesterday") over scrolling. Combine day with a higher limit to see everything from that day.

Check whether the sidebar and command panel are currently visible, without changing their state. Use this instead of toggling just to check.

Toggle SupaSidebar visibility (show/hide). Returns the new visibility state.

Launch the SupaSidebar app if it's not already running. Uses macOS 'open -a' command.

Toggle the SupaSidebar command panel (search/command palette). Opens it if closed, closes it if open.

Switch to a different space. Spaces organize your links into separate workspaces. Get space IDs from list_spaces.

Open the SupaSidebar Preferences window, optionally jumping to a specific tab. Useful when the user wants to see or adjust settings visually.

Get SupaSidebar settings. With no arguments: returns all 40+ settings grouped by category. With 'key': returns a single setting by exact key or natural-language alias (e.g. 'compact mode', 'smart attach', 'atc'). With 'category': filters to one group.

Change a SupaSidebar setting. Use get_settings first to see available settings and their current values. Boolean settings use true/false, string settings use the documented options.

Enable a named feature preset that configures multiple settings at once. Presets: 'Smart Attach' (auto-show with browser), 'Independent Mode' (always visible), 'Space Isolation' (separate tabs per space), 'Minimal Sidebar' (compact and clean), 'Full Featured' (everything on). Use get_settings to see all presets.

List all configurable keyboard shortcuts with their current key bindings. Shows the shortcut name (used for updates), display string, title, and description.

Change a keyboard shortcut binding. Requires at least one modifier key. Use get_shortcuts to see available shortcut names.

Remove a keyboard shortcut binding so it no longer has a key combination assigned.

Open a URL in a specific browser, browser profile, or the default browser. IMPORTANT: if the user names a browser ('open in Brave', 'in my Work profile'), you MUST set the browser (and profileId) parameter - omitting it falls back to the system default browser, which is usually NOT what was asked for. Supported browsers (27 total): Safari, Chrome, Firefox, Edge, Arc, Brave, Vivaldi, Dia, Comet, Orion, Zen, Atlas, Wavebox, Helium, plus Chromium and Thorium, plus dev/beta/canary channels of Chrome (Beta/Canary/Dev), Edge (Beta/Canary/Dev), Brave (Beta/Nightly), Vivaldi (Snapshot), and Firefox (Nightly/Developer Edition). These are RECOGNIZED but not necessarily INSTALLED on this user's machine - if open_link returns an 'is not installed' error, call list_installed_browsers to see what's actually available and pick from those. For profile-specific opening, call list_browser_profiles first to get profile IDs.

Search the web using a search engine or custom website shortcut. Built-in engines: Google, Bing, DuckDuckGo, Yahoo, Perplexity, Brave, Kagi. Custom shortcuts let you search specific sites (e.g. YouTube, Reddit, GitHub). Use list_search_shortcuts to see all available.

List all available search engines and custom website search shortcuts. Shows built-in engines (Google, Bing, etc.) and user-created shortcuts (YouTube, Reddit, etc.) with their keywords for use with web_search.

Add a custom website search shortcut so you can search a specific site via web_search. The searchURL should be the site's search URL with the query parameter at the end (e.g. 'https://www.youtube.com/results?search_query=').

Remove a custom website search shortcut by its keyword or ID.

Create a new space in SupaSidebar. Spaces are top-level collections that organize your links.

Create a new folder inside a space. Use list_spaces for space IDs, list_folders for parent folder IDs.

Save a new link to SupaSidebar. If name is omitted, the title is fetched from the page automatically.

Move an existing link to a different space or folder. Get link IDs from list_links or search. Pass targetFolderId as null to move to root (unfiled).

List all Air Traffic Control (ATC) rules. ATC rules automatically route URLs to specific spaces (save rules) or browsers/profiles (open rules). Rules are evaluated top-to-bottom; first match wins.

Create a new Air Traffic Control rule. Save rules route saved links to a specific space. Open rules open matching URLs in a specific browser/profile. Use list_browser_profiles to get profile IDs and list_spaces to get space IDs.

Update an existing ATC rule. Only the fields you provide will be changed. Get rule IDs from list_atc_rules.

Delete an ATC rule by ID. Get rule IDs from list_atc_rules.

Change ATC rule priority order. Rules are evaluated top-to-bottom, first match wins. Provide all rule IDs in desired order.

List browser profiles discovered by SupaSidebar. Use this to get profile IDs for ATC rules that route URLs to a specific browser profile (e.g. 'Safari Work profile').

List browsers actually installed on this machine. Call this BEFORE open_link if you're not sure whether a browser the user named is available - SupaSidebar recognizes 27 browsers (14 main browsers plus dev/beta/canary channels and Chromium variants), but recognized doesn't mean installed. Returns each browser's name (the exact string to pass to open_link's browser param), whether it's running, and which is the system default.