# atmos mcp uninstall

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

> ⚠️ Experimental

## 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`](/cli/commands/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

```shell
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

```shell
# 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
```