everymcp

everymcp

Universal MCP server installer CLI. Add, remove, and manage Model Context Protocol servers across all your coding agents from a single command.

Note: This project is in early development (v0.1.0) and has not been tested with every supported IDE/agent. If you run into a bug, please create an issue.

Supported Agents

Agent	Transports	Scopes
Claude Desktop	stdio	global
Claude Code	stdio	global, project
OpenAI Codex	stdio	global, project
Cursor	stdio, http, sse	global, project
Windsurf	stdio	global
VS Code	stdio, http, sse	global, project
Zed	stdio	global
Sourcegraph Cody	stdio	global
Cline	stdio, http, sse	global, project
Roo Code	stdio, http, sse	global, project
JetBrains	stdio	global, project
Neovim	stdio	global
Kilo Code	stdio, http, sse	global, project
Amazon Q	stdio	global
Gemini CLI	stdio	global

Install

From npm (once published)

npm install -g everymcp

From source

git clone https://github.com/am-will/everymcp.git
cd everymcp
npm install
npm run build
npm link

npm link creates a symlink so the everymcp command is available on your PATH. You can verify with:

which everymcp
everymcp --version

Run without installing

npx everymcp

Usage

Interactive wizard (default)

everymcp

Launches a TUI that walks you through adding a server to your detected agents.

Add a server

# stdio server
everymcp add "npx -y @modelcontextprotocol/server-filesystem /home/user/docs"

# HTTP/SSE server
everymcp add "https://mcp.example.com/sse"

# Target specific agents
everymcp add "npx -y some-server" --agents cursor,claude-desktop

# Add to all detected agents
everymcp add "npx -y some-server" --all

# With environment variables
everymcp add "npx -y some-server" -e API_KEY=sk-123 -e DEBUG=true

# With auth token
everymcp add "https://mcp.example.com" --auth-token sk-123

# Custom server name
everymcp add "npx -y some-server" --name my-server

# Dry run (preview changes without writing)
everymcp add "npx -y some-server" --all --dry-run

Remove a server

everymcp remove my-server --agents cursor,vscode
everymcp remove my-server --all

List configured servers

everymcp list
everymcp list --agents claude-desktop

Detect installed agents

everymcp detect

Backup and restore

everymcp backup
everymcp restore
everymcp restore --latest

Global Options

Flag	Description
--agents <list>	Comma-separated agent IDs to target
--all	Target all detected agents
--dry-run	Preview changes without writing
--force	Overwrite existing entries without prompting
--name <name>	Override the inferred server name
-e, --env <K=V>	Set environment variable (repeatable)
--header <K=V>	Set HTTP header (repeatable)
--auth-token <token>	Set bearer auth token
--transport <type>	Force transport: stdio, http, or sse
--global	Use global config scope (default)
--project	Use project-level config scope
--no-backup	Skip automatic config backup before changes

How It Works

everymcp auto-detects which coding agents are installed on your system by checking for their config files. Each agent has an adapter that knows:

• Where config files live on each OS (macOS, Linux, Windows)
• How to transform a canonical MCP server spec into the agent's specific JSON format
• Which transports and scopes the agent supports

Config files are read and written using jsonc-parser to preserve comments and formatting. Writes are atomic (temp file + rename) with per-file mutex locking to prevent race conditions.

Development

git clone https://github.com/am-will/everymcp.git
cd everymcp
npm install
npm run build    # TypeScript compilation
npm run dev      # Run directly via tsx

License

MIT