QGIS MCP Server

An MCP (Model Context Protocol) server that exposes QGIS capabilities to AI agents. Supports both headless mode (stdio) and live QGIS desktop integration (SSE).

Features

• 23 tools covering project management, layer inspection, spatial queries, styling, and map export

• Headless mode — standalone process using qgis_process-style QGIS session

• Desktop mode — live connection to a running QGIS instance via SSE/HTTP

• Zero-friction setup — uses system QGIS Python bindings, no extra dependencies

Tools

Quick Start

# Install
pip install -e .

# Run headless
qgis-mcp

# Or use with opencode — add to .config/opencode/opencode.jsonc:
{
  "mcp": {
    "qgis": {
      "type": "local",
      "command": ["qgis-mcp"]
    }
  }
}

Desktop Plugin

Install the QGIS plugin from src/qgis_mcp_plugin/ to connect to a live QGIS session:

ln -s $(pwd)/src/qgis_mcp_plugin ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/

Then enable qgis_mcp_plugin in QGIS's Plugin Manager and add to your opencode config:

{
  "mcp": {
    "qgis-desktop": {
      "type": "remote",
      "url": "http://127.0.0.1:9876/sse"
    }
  }
}

License

MIT