Delv
CommunityAbandoned· 8mo4.3by Jose Santos

QGIS MCP

Connects QGIS Desktop to Claude for prompt-assisted project creation, layer loading, and code execution.

D
Safety & Trust

Delv Safety Grade: D

Score 42/100 · assessed 2026-04-18

Maintainer35
Permissions25
Supply chain35
Transparency55
Incidents100

QGIS MCP is a community server by solo developer Jose Santos that bridges Claude to QGIS Desktop for geospatial work. The server executes arbitrary Python code in QGIS's environment, providing essentially unrestricted desktop application control and code execution capabilities. Installation requires cloning the repository and running via uv with no package distribution. The maintainer appears to be a single developer with limited visible activity beyond this project. While the repository is open source with basic documentation, the lack of packaged distribution, combined with desktop automation and code execution permissions, creates significant supply chain and permission scope risks. No security incidents are known, but the attack surface is substantial: malicious prompts could execute arbitrary QGIS Python API calls affecting the user's desktop GIS environment and filesystem.

Green flags

  • Open source repository with visible code
  • Specific use case (QGIS automation) limits general abuse surface
  • No environment secrets required for basic operation
  • No known security incidents to date

Red flags

  • Executes arbitrary Python code in QGIS Desktop environment
  • No package distribution, clone-and-run installation only
  • Solo maintainer with limited public track record
  • Desktop application control with broad automation scope
  • No sandboxing or execution constraints visible

Permissions requested

Desktop controlShell executeRead filesWrite filesOutbound network
Assessed by Delv Editorial using public metadata. Grades are advisory and update as the ecosystem changes. They do not replace your own review of permissions and code before granting an agent access to sensitive systems.

Install

uv --directory ./src/qgis_mcp run qgis_mcp_server.py

Review

QGIS MCP bridges Claude Desktop and QGIS, the open-source GIS workhorse. You can ask Claude to create a project, load shapefiles or rasters, run processing algorithms, and execute PyQGIS code without touching the QGIS interface. It's a prompt-driven workflow for spatial data that feels surprisingly natural once you get past the setup. I'd reach for this when prototyping spatial analyses or teaching someone QGIS without forcing them through the GUI labyrinth. Ask Claude to load a boundary file, clip it to a region, calculate area, and export a styled map. The server handles the PyQGIS plumbing. It's faster than clicking through menus and documenting steps in a script at the same time. The install is fiddly. You need QGIS installed with a working Python environment, and the uv command assumes you've cloned the repo and are running from the right directory. The config snippet is listed as not applicable, which means you're piecing together the Claude Desktop setup from the repo README. Once it's wired up, though, it works. Claude can query available layers, run QGIS processing tools by name, and execute arbitrary PyQGIS. That last bit is powerful but also means you're trusting Claude to write correct spatial code. Quirks: QGIS must be running for the server to work, which isn't obvious from the name. It's not a standalone spatial engine, it's a remote control for an existing QGIS session. If you close QGIS, the MCP goes silent. Also, error messages from failed PyQGIS commands can be cryptic. Claude will try to fix them, but you'll want basic QGIS Python knowledge to debug. This isn't for casual users. If you don't already use QGIS or don't have spatial data workflows, the setup cost isn't worth it. But if you're a GIS analyst who wants to script workflows conversationally or a developer building spatial tools, it's a clever shortcut. It won't replace QGIS for production work, but it makes exploration and iteration much faster.
Verdict

Install this if you already use QGIS and want to prototype spatial workflows through Claude instead of clicking menus. Skip it if you're not comfortable with QGIS Python or don't have geospatial data to work with. The setup friction is real, but the payoff is a conversational interface to serious GIS power.

Good at

  • Lets you script QGIS workflows conversationally without memorising PyQGIS syntax or menu paths.
  • Supports the full QGIS processing toolbox, so you can chain spatial operations through prompts.
  • Useful for teaching or prototyping, where the GUI would slow you down.
  • Works with real QGIS projects, so you can switch between prompt-driven and manual work.

Watch out

  • Requires QGIS to be running, which isn't clear from the name and adds friction.
  • Setup is manual and assumes familiarity with QGIS Python environments and MCP config files.
  • Error handling is thin, so failed PyQGIS commands can leave you guessing what went wrong.
  • Only tested with Claude Desktop, so other hosts may need custom wiring.

Use cases

  • geospatial analysis
  • map creation from prompts
  • GIS workflows
  • spatial data processing

Getting started

1. Install QGIS Desktop and ensure its Python environment is accessible. Clone the repo from https://github.com/jjsantos01/qgis_mcp. 2. Run the install command from the repo root: `uv --directory ./src/qgis_mcp run qgis_mcp_server.py`. This starts the MCP server. 3. Add the server to your Claude Desktop config by editing the MCP settings file. The repo README should have the JSON snippet you need, including the command path and any arguments. 4. Launch QGIS Desktop, then restart Claude Desktop. Test by asking Claude to create a new QGIS project or list available processing algorithms. 5. Watch out: QGIS must stay open while you're using the MCP. If you close it, Claude loses access and commands will fail silently or with vague errors.

Works with

Claude DesktopClaude CodeCursor

Similar MCPs