QGIS

Open QGIS and go to Plugins > Manage and Install Plugins. Search for 'QGIS MCP' in the All tab and click Install Plugin. Restart QGIS after installation. The plugin adds a dock widget with a 'Start Server' button.

In QGIS, open the MCP dock widget (usually in the side panel after installation) and click 'Start Server'. The server listens on localhost:9876 by default. The dock widget confirms when the server is running.

Add the qgis-mcp-server to your AI client configuration. The MCP server connects to the QGIS socket server on port 9876. Use uvx for zero-installation execution or install from the GitHub zip.

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

If you are using Claude Code (the CLI), add the QGIS MCP server with a single command that handles registration automatically.

claude mcp add -s user qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server

In your AI client, ask Claude to ping the QGIS connection. A successful pong response confirms the three-way connection (AI client → MCP server → QGIS plugin) is working.

QGIS MCP supports two tool modes. Granular mode exposes 102 individual tools for fine-grained control. Compound mode provides ~23 higher-level tools that combine multiple operations. Switch modes via the QGIS_MCP_TOOL_MODE environment variable.

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ],
      "env": {
        "QGIS_MCP_TOOL_MODE": "granular"
      }
    }
  }
}