atmos mcp uninstall

Use this command to remove MCP servers previously installed into AI client config files.

Experimental

atmos mcp uninstall --help

Description

The atmos mcp uninstall command removes matching server entries from each targeted client's config file. It's the mirror image of atmos mcp install — it only touches client config files and never edits atmos.yaml.

With no server names given, it uninstalls everything currently declared under mcp.servers. If a client's config file becomes empty after removal, the file is left in place (not deleted) — matching install's behavior of never deleting files.

Usage

atmos mcp uninstall [server-name...] [flags]

server-name...

Optional list of specific server names to uninstall. When omitted, all servers configured under mcp.servers are uninstalled.

--client, -c

MCP client to uninstall from (repeatable): claude-code, cursor, vscode, codex, gemini, claude-desktop, windsurf, cline, cline-cli, zed, opencode, goose, copilot-cli, antigravity, mcporter. When omitted, Atmos detects clients already configured in the project.

--all-clients

Uninstall from all supported MCP clients instead of just detected or explicitly selected ones.

--scope

Uninstall scope: project (default) or user. When omitted (along with --global) in an interactive terminal, Atmos prompts you to choose; non-interactive runs (--yes, no TTY, or CI) fall back to project.

--global, -g

Alias for --scope user.

--yes, -y

Skip confirmation prompts.

--dry-run

Show what would be removed without writing any files.

Examples

# Remove all configured servers from detected project clients.
atmos mcp uninstall

# Remove one server from Cursor and Claude Code project configs.
atmos mcp uninstall aws-docs --client cursor --client claude-code

# Remove from user-level config.
atmos mcp uninstall --scope user --client codex

# Preview what would be removed without writing files.
atmos mcp uninstall --dry-run