qgis_mcp

Level ALocal

Model Context Protocol (MCP) that allows LLMs to use QGIS Desktop

Overview

QGISMCP connects QGIS Desktop to Claude AI via the Model Context Protocol, letting the model directly control QGIS. It combines a QGIS plugin with a Python MCP server and supports creating, loading and saving projects, adding or removing vector and raster layers, running Processing Toolbox algorithms, executing PyQGIS code, and rendering the map view. It suits prompt-assisted GIS project setup and layer work.

⭐ 1.2kDevelopment ToolsPythonRepo ↗Updated 2025-10-01

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "jjsantos01-qgis-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO>/qgis_mcp/src/qgis_mcp",
        "run",
        "qgis_mcp_server.py"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/jjsantos01/qgis_mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "jjsantos01-qgis-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO>/qgis_mcp/src/qgis_mcp",
        "run",
        "qgis_mcp_server.py"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers