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