Skip to content
Tresca

QGISMCP

MCP serverCommunity

A QGIS plugin opens a local socket inside QGIS Desktop so Claude can load layers, run Processing tools and render maps. By jjsantos01.

1.1k starsUpdated 1 year agoGitHub data from 5 Nov 2026

At a glance

Type
MCP server
Works with
QGIS
How it connects
Drives a running copy of the tool
Access
Can modify models
Tool versions
QGIS 3.x (the author says only 3.22 was tested)
Operating systems
Windows, macOS
Needs a QGIS licence
No
Transport
Local (stdio)
AI clients documented
Claude Desktop
Licence
Not stated in its documentation
Language
Python

What it can do

  • Creates, opens and saves QGIS projects, and adds or removes vector and raster layers.
  • Runs algorithms from the Processing Toolbox with parameters the agent supplies.
  • Reads features from a vector layer and renders the current map view to an image file.
  • Can run any PyQGIS code inside the open QGIS session through an execute_code tool.

Limitations

  • You copy the plugin folder into your QGIS profile by hand and press Start Server each session.
  • Only QGIS 3.22 is stated as tested, and the README gives plugin paths for Windows and macOS only.
  • The arbitrary-code tool has no sandbox; the author warns to use it with care.
  • No licence file in the repository, and no pushes since October 2025.

Install

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
                "run",
                "qgis_mcp_server.py"
            ]
        }

    }
}

Source: github.com/jjsantos01/qgis_mcp#claude-for-desktop-integration

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.