Uninstall MCP

Remove the QueryDeck MCP server from one or all AI editors without breaking other MCP integrations.

For: developers.

qdeck mcp uninstall removes the querydeck entry from each editor's MCP config. Other MCP servers you've added to the same config are untouched.

Remove from all clients

qdeck mcp uninstall

Output:

Uninstalling from:
  ✓ Claude Desktop — removed
  ✓ Claude Code   — removed
  ✓ Cursor        — removed
  • Windsurf      — entry not found (already removed)

3 of 4 clients cleared.
Restart your editor to drop the server.

The CLI never deletes the editor's config file. If querydeck was the only MCP server configured, the mcpServers object is left in place (empty) — the editor stays valid.

Remove from specific clients

qdeck mcp uninstall cursor               # only Cursor
qdeck mcp uninstall claude claude-code   # specific list

Available identifiers: claude, claude-code, cursor, windsurf.

Verify removal

qdeck mcp status

After uninstall, the affected clients show installed (not configured) instead of configured.

Manual removal

If qdeck mcp uninstall isn't available (CLI not installed, app deleted), edit the config file directly. Remove the querydeck key from the mcpServers object:

Client	Edit this file
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Code	`~/.claude/settings.json`
Cursor	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`

Before:

{
  "mcpServers": {
    "querydeck": {
      "command": "/Applications/QueryDeck.app/Contents/MacOS/querydeck-mcp"
    },
    "github": {
      "command": "..."
    }
  }
}

After:

{
  "mcpServers": {
    "github": {
      "command": "..."
    }
  }
}

Restart the editor.

Uninstalling the QueryDeck app

If you delete QueryDeck from /Applications, the MCP server stops working but the entries in your editor configs remain. The editors will fail to spawn querydeck-mcp and log an error.

Clean removal before deleting the app:

qdeck mcp uninstall  # remove from all clients
qdeck --uninstall-cli # remove /usr/local/bin/qdeck symlink

Then drag QueryDeck to the Trash. If you skipped the uninstall and deleted the app first, the symlink at /usr/local/bin/qdeck will be broken — remove it manually:

sudo rm /usr/local/bin/qdeck

And edit each editor's config to remove the querydeck entry.

Reinstalling later

If you want to reinstall after a clean uninstall (e.g., to point at a different QueryDeck version or location):

qdeck mcp install

The install is idempotent. Running it again over an existing config is safe and just refreshes the binary path.

What's next

Overview for the conceptual model
Install for the setup flow
Safety for what the server allows by default