SSyncDev

Qgis MCP Server

QGISMCP connects [QGIS](https://qgis.org/) to [Claude AI](https://claude.ai/chat) through the [Model Context Protocol

Local serverstdioPython

What is the Qgis MCP Server?

QGISMCP connects QGIS to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control QGIS. This integration enables prompt assisted project.

What Qgis MCP does

QGISMCP connects QGIS to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control QGIS. This integration enables prompt assisted project creation, layer loading, code execution and more.

Key capabilities

  • 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

Requirements

  • QGIS 3.X (only tested on 3.22) - Claude desktop - Python 3.10 or newer - uv package manager: If you're on Mac, please install uv as On Windows Powershell Otherwise installation instructions are on their website: Install uv ⚠️ Do not proceed before installing UV

Practical notes

  • Maintained by jjsantos01, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
pingSimple ping command to check server connectivity
get_qgis_infoGet QGIS information about the current installation
load_projectLoad a QGIS project from the specified path
create_new_projectCreate a new project and save it
get_project_infoGet current project information
add_vector_layerAdd a vector layer to the project
add_raster_layerAdd a raster layer to the project
get_layersRetrieve all layers in the current project
remove_layerRemove a layer from the project by its ID
zoom_to_layerZoom to the extent of a specified layer
get_layer_featuresRetrieve features from a vector layer with an optional limit
execute_processingExecute a processing algorithm with the given parameters
save_projectSave the current project to the given path
render_mapRender the current map view to an image file
execute_codeExecute arbitrary PyQGIS code provided as a string

How to install the Qgis MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • QGIS 3.X (only tested on 3.22) - Claude desktop - Python 3.10 or newer - uv package manager: If you're on Mac, please install uv as On Windows Powershell Otherwise installation instructions are on their website: Install uv ⚠️ Do not proceed before installing UV

Example prompts to try

  • “Use Qgis MCP to ping.”
  • “Use Qgis MCP to get qgis info.”
  • “Use Qgis MCP to load project.”

Frequently asked questions

QGISMCP connects [QGIS](https://qgis.org/) to [Claude AI](https://claude.ai/chat) through the [Model Context Protocol Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.