QGISMCP - QGIS Model Context Protocol Integration

Features

• Two-way communication: Connect Claude AI to QGIS through a socket-based server.
• Project manipulation: Create, load and save projects in QGIS.
• Layer manipulation: Add and remove vector or raster layers to a project.
• Execute processing: Execute processing algorithms (Processing Toolbox).
• Code execution: Run arbitrary Python code in QGIS from Claude. Very powerful, but also be very cautious using this tool.

Components

1. QGIS plugin: A QGIS plugin that creates a socket server within QGIS to receive and execute commands.
2. MCP Server: A Python server that implements the Model Context Protocol and connects to the QGIS plugin.

Installation

Prerequisites

• QGIS 3.X (only tested on 3.22)
• Cloud desktop
• Python 3.10 or newer
• uv package manager:

brew install uv

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Download code

git clone git@github.com:jjsantos01/qgis_mcp.git

QGIS plugin

Settings

User profiles

Open active profile folder

Python/plugins

qgis_mcp_plugin

On a Windows machine the plugins folder is usually located at:

C:\Users\USER\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins

and on MacOS:

~/Library/Application\ Support/QGIS/QGIS3/profiles/default/python/plugins

Plugins

Installing and Managing Plugins

All

Claude for Desktop Integration

Claude

Settings

Developer

Edit Config

claude_desktop_config.json

If you cann't find the "Developers tab" or the

claude_desktop_config.json

look at this documentation.

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

    }
}

Usage

Starting the Connection

1. In QGIS, go to

   plugins

   ->

   QGIS MCP

   ->

   QGIS MCP

   
2. Click "Start Server"

Using with Claude

Tools

• ping

  - Simple ping command to check server connectivity

• get_qgis_info

  - Get QGIS information about the current installation

• load_project

  - Load a QGIS project from the specified path

• create_new_project

  - Create a new project and save it

• get_project_info

  - Get current project information

• add_vector_layer

  - Add a vector layer to the project

• add_raster_layer

  - Add a raster layer to the project

• get_layers

  - Retrieve all layers in the current project

• remove_layer

  - Remove a layer from the project by its ID

• zoom_to_layer

  - Zoom to the extent of a specified layer

• get_layer_features

  - Retrieve features from a vector layer with an optional limit

• execute_processing

  - Execute a processing algorithm with the given parameters

• save_project

  - Save the current project to the given path

• render_map

  - Render the current map view to an image file

• execute_code

  - Execute arbitrary PyQGIS code provided as a string

Example Commands

You have access to the tools to work with QGIS. You will do the following:
	1. Ping to check the connection. If it works, continue with the following steps.
	2. Create a new project and save it at: "C:/Users/USER/GitHub/qgis_mcp/data/cdmx.qgz"
	3. Load the vector layer: ""C:/Users/USER/GitHub/qgis_mcp/data/cdmx/mgpc_2019.shp" and name it "Colonias".
	4. Load the raster layer: "C:/Users/USER/GitHub/qgis_mcp/data/09014.tif" and name it "BJ"
	5. Zoom to the "BJ" layer.
	6. Execute the centroid algorithm on the "Colonias" layer. Skip the geometry check. Save the output to "colonias_centroids.geojson".
	7. Execute code to create a choropleth map using the "POB2010" field in the "Colonias" layer. Use the quantile classification method with 5 classes and the Spectral color ramp.
	8. Render the map to "C:/Users/USER/GitHub/qgis_mcp/data/cdmx.png"
	9. Save the project.