v0.5.20 — Toggles, live health & Gemini CLI

One‑click MCP servers
for every app

A tiny Mac menu bar app that installs, syncs, and manages Model Context Protocol servers across Claude Desktop, Cursor, VS Code, Windsurf, Zed, Codex CLI, Gemini CLI, and more. Local. Free. Open source.

macOS 14+ · Apple Silicon and Intel · MIT licensed
$brew install --cask vishmathpati/mcpbolt/mcpboltbar
mcpbolt
32 servers
9 apps
By App
Coverage
Projects
Settings
Claude Desktop
4 servers · 3 enabled
Sync to all ↗
context7
global
posthog
global
supabase
global
magic
global
📋Paste a config, npx command, or URL…Import
Reachable
Degraded
Unreachable
Not checked
The problem

You added one server.
Now it runs everywhere.

MCP servers are installed globally by default. Every project you open loads every server — eating context tokens and burning through your subscription limit, whether you need those servers or not.

Without MCPBolt

Every MCP server you install runs globally — loaded on every project, every session, burning context tokens you're paying for.

No visibility into which servers are active in which tools without hunting through JSON config files.

Turning a server off means editing config files by hand. Turning it back on is just as painful.

With MCPBolt

Add a project folder — only servers assigned to that project run when you're in it. Global servers stay off by default.

Toggle any server on or off per app with one click, any time, without losing your configuration.

Coverage matrix shows every server across every tool and project at a glance — no config files, no guessing.

Projects tab

Global and per‑project,
fully in your control

Drop any project folder into MCPBolt. Assign only the servers that project needs. Those servers activate when you open the project — and only then. Your global servers are grouped separately and can be toggled off per app independently.

  • 📁Drop a folder — MCPBolt auto‑detects Claude Code and Codex CLI projects
  • 🔒Project servers are scoped to .mcp.json or .cursor/mcp.json — never global
  • Global servers are grouped separately; disable them per app in one click
  • 🔄Sync any server from project scope to global, or the other way around
mcpbolt
Projects
By App
Coverage
Projects
Settings
Global
context7
all apps
posthog
all apps
~/projects/snapfinder
supabase
.mcp.json
context7
.mcp.json
posthog
.mcp.json
+ Add project folder
How it works

Paste once. Wire everywhere.

MCPBolt reads whatever format a server ships in and translates it into the right config for every app you use — no JSON editing, no terminal.

1

Paste any config

Paste a JSON snippet, an npx command, a Docker run line, or a bare URL. MCPBolt detects the format automatically.

{ "mcpServers": "supabase": … }
2

Pick your targets

Select which apps and scopes to write to. MCPBolt shows only the tools it detects on your Mac.

Claude Desktop
Cursor (global)
VS Code (project)
3

Done — servers wired

MCPBolt writes the correct JSON or TOML to every target, makes backups, and tells you which apps need a restart.

✓ Claude Desktop — written
✓ Cursor (global) — written
→ Quit and reopen Claude Desktop
→ Cursor: Settings → MCP → Refresh
Features

Everything you'd want, nothing you wouldn't

MCPBolt does one job. It writes the right config to the right file, every time, across every app.

One‑click install

Add any MCP server to Claude, Cursor, VS Code, Windsurf, Zed, Codex CLI, and more in a single action. No JSON editing required.

🟢

Enable / disable toggle

Turn any server on or off per app without removing it. Green means enabled, red means disabled. Your config is preserved and restored instantly.

🚦

Always‑on health status

Green, amber, or red — auto‑refreshed every minute. See which servers are reachable or broken at a glance, always, not just on demand.

🔁

Sync across apps

Copy a server to every other tool in one action. MCPBolt handles each app's unique config format automatically.

✏️

Edit in place

Update a server's command, args, and environment variables through a real form — no terminal, no backslash escaping.

🗑️

Remove from everywhere

Remove a server from every tool at once, or from just one. You're always in control.

📋

Smart paste

Paste a JSON config, a CLI command like `claude mcp add`, or a bare URL — MCPBolt auto‑detects the format and writes it to the right place.

📊

Coverage matrix

See every server side‑by‑side across all your tools. Hide columns you don't need. Coverage gaps are obvious at a glance.

🗂️

Projects tab

Manage per‑repo MCP configs from one place. Switch between global and project‑scoped servers without touching any files manually.

🔍

Auto‑discovery

MCPBolt scans your Mac for Claude Code and Codex CLI projects automatically — no manual setup needed.

🔄

Restart host apps

After a config change, MCPBolt can relaunch Claude, Cursor, or VS Code so changes take effect immediately.

↩️

Undo last change

Every write creates a timestamped backup. One click restores the previous state.

🖥️

Full‑screen dashboard

Expand beyond the menu bar into a resizable full‑screen window with sidebar navigation.

🚀

Launch at login

Starts quietly in the menu bar and stays out of your way until you need it.

Works with

Every major MCP client

Native apps, editor extensions, and CLIs. MCPBolt translates each app's config format automatically — nothing to configure.

Claude Desktop
Claude Code
Cursor
Codex CLI
VS Code
Windsurf
Zed
Gemini CLI
opencode
Roo
Security

Your config is yours

MCPBolt runs entirely on your machine. No server, no account, no data leaves your disk.

Atomic writes

Config files are written atomically. If the disk dies mid‑write, the old file is still intact.

Timestamped backups

Every edit keeps the last three backups per file. Older .bak files rotate out automatically.

Local‑only

MCPBolt never phones home. No telemetry, no account, no cloud. It edits files on your disk and nothing else.

Open source

MIT licensed. Read the code, build it yourself, fork it. Trust by inspection.

Start in 30 seconds

Download the menu bar app or run the CLI. Free. No account. No credit card.

macOS 14+ · Apple Silicon and Intel · MIT licensed