/mcp disable <server>

How to disable an MCP server in Claude Code

Too many MCP servers slow Claude Code down and crowd its context with tools. You can switch one off and keep its configuration, or remove it entirely. Here is each option and what it changes.

Switch it off, keep the configuration

Inside Claude Code, open /mcp, select the server and toggle it off, or type /mcp disable <server>. Claude Code stops connecting to it but keeps it listed as disabled, so you can turn it back on later. The on/off state is stored per project in ~/.claude.json. (Anthropic: MCP)

Remove it completely

claude mcp list            # see every server and its scope
claude mcp remove <name>   # delete it from its config

A server added at local or user scope lives in ~/.claude.json; a project server lives in the project's .mcp.json, which you can also edit by hand.

Project servers from .mcp.json: approval is a separate switch

The first time Claude Code sees servers in a project's .mcp.json, it asks whether to approve them. Your answers are stored as enabledMcpjsonServers and disabledMcpjsonServers in your settings. Anthropic's docs are explicit that these approval lists are unrelated to the on/off toggle above — a server can be approved and still switched off.

You want toDo thisWhere it's stored
Pause a server/mcp → toggle off, or /mcp disable <server>~/.claude.json, per project
Delete a serverclaude mcp remove <name>Its own config file
Refuse a project's serverDecline it when asked, or list it in disabledMcpjsonServersSettings file

Find the server you can't find

If a server keeps appearing, it may be defined somewhere you haven't looked: a .mcp.json in a parent folder, your user config, or a plugin that ships one. claude mcp list shows the scope of each.

From a sidebar instead

Claude Code Manager's MCP tab lists every server with the file it comes from and a switch beside it, so you can pause several at once without opening a settings file. It writes the same state Claude Code reads.

FAQ

Questions, answered

Does disabling a server delete its configuration?

No. Toggling a server off in /mcp keeps it listed as disabled; turn it back on any time. claude mcp remove is the command that deletes it.

Is disabledMcpjsonServers the same as disabling?

No. Anthropic's docs say enabledMcpjsonServers and disabledMcpjsonServers control approval of servers from a project's .mcp.json, and are unrelated to the on/off toggle.

Free, open source, and it stays on your machine.

Apache-2.0. No telemetry, no account, no network client. Works with the Claude Code CLI and the official extension.

code --install-extension vishalguptax.claude-manager