| name | deactivate-mcp |
| description | Remove an MCP server from the current project's .mcp.json and disable it in .claude/settings.json. Symmetric counterpart to activate-mcp. |
deactivate-mcp
Unmount an MCP server from the current project. Removes it from .mcp.json and from enabledMcpjsonServers in .claude/settings.json.
Inputs
The user names an MCP server. If ambiguous, run list-active.
Steps
- Determine project root (cwd or nearest
.git/.claude ancestor).
- Read
<project>/.mcp.json. If missing or the server isn't present, say so and stop.
- Delete the entry under
mcpServers["<name>"]. Write the file back with 2-space indentation. If mcpServers becomes empty, leave it as {}.
- Read
<project>/.claude/settings.json. If enabledMcpjsonServers contains the name, remove it. Write back.
- Confirm: server name, files edited, restart reminder.
Safety
- Project-scoped only.
- Do not delete the user's
.mcp.json file even if it ends up empty — leave the empty { "mcpServers": {} } shell.
- Surface any
settings.local.json overrides separately.
Output style
One-line confirmation. Restart reminder.
