QGIS MCP

Free

connects QGIS Desktop to Claude AI through the MCP. This integration enables prompt-assisted project creation, layer loading, code execution, and more.

FreeFree tier

Type

Open Source

Visit Website GitHub (40 stars)

About QGIS MCP

QGIS MCP (Model Context Protocol) integrates QGIS Desktop with Claude AI, allowing direct AI-driven control of QGIS via natural language prompts. The system consists of two components: a QGIS plugin that runs a socket server inside QGIS, and an MCP server that connects Claude to that plugin. Features include two-way communication, project creation/loading/saving, adding and removing vector and raster layers, executing processing algorithms from the Processing Toolbox, and running arbitrary Python code in QGIS. Installation requires QGIS 3.X (tested on 3.22), Python 3.10+, and the uv package manager. The plugin is open source and freely available on GitHub.

Key Features

Two-way communication between Claude AI and QGIS via a socket-based server

Project manipulation: create, load, and save QGIS projects

Layer manipulation: add and remove vector and raster layers

Execute processing algorithms from the Processing Toolbox

Run arbitrary Python code in QGIS from Claude

MCP server and QGIS plugin architecture

Integration with Claude for Desktop

Pros & Cons

Pros

Enables AI-driven GIS workflows without manual GUI interaction
Open source and free to use
Based on the established Model Context Protocol
Supports complex QGIS operations like processing algorithms and custom code
Two-way communication provides tight integration between Claude and QGIS

Cons

Arbitrary code execution poses security risks; requires cautious use
Requires manual installation of both a QGIS plugin and MCP server
Dependent on QGIS 3.X (only tested on 3.22), Python 3.10+, and uv package manager
Not a standalone tool; requires Claude for Desktop and configuration
Limited to features exposed by the MCP server; not all QGIS functionality covered

Best For

GIS project creation and management using natural language promptsAutomated layer loading and manipulation for mapping workflowsExecuting GIS processing and analysis algorithms through conversational AIRunning custom Python scripts in QGIS from Claude for advanced automation

FAQ

What is QGIS MCP?

QGIS MCP is an open-source integration that connects QGIS Desktop to Claude AI through the Model Context Protocol, allowing Claude to directly interact with and control QGIS via natural language prompts.

What are the main components of QGIS MCP?

The system consists of two components: a QGIS plugin that creates a socket server within QGIS to receive and execute commands, and a Python MCP server that implements the Model Context Protocol and connects to the QGIS plugin.

What are the prerequisites for installing QGIS MCP?

You need QGIS 3.X (tested on 3.22), Claude for Desktop, Python 3.10 or newer, and the uv package manager. The uv package manager can be installed via Homebrew on Mac or the official script on Windows.

How do I install the QGIS plugin?

Copy the qgis_mcp_plugin folder to your QGIS profile's Python/plugins directory. Then open QGIS, go to Plugins > Manage and Install Plugins, search for 'QGIS MCP', and enable it.

How do I start using QGIS MCP with Claude?

In QGIS, go to Plugins > QGIS MCP > QGIS MCP and click 'Start Server'. Then configure Claude for Desktop by editing claude_desktop_config.json with the path to the MCP server script. Once connected, a hammer icon with tools will appear in Claude.

What tools does QGIS MCP expose to Claude?

Tools include ping (check server connectivity), get_qgis_info (get QGIS installation details), load_project, and other commands for project and layer manipulation, processing execution, and code execution.