← Back to QGIS MCP

Install QGIS MCP

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add qgis-mcp -- uv run src/qgis_mcp/server.py

Available Tools (6)

Once configured, QGIS MCP gives your AI agent access to:

load_projectLoads a QGIS project file.
path
create_new_projectCreates a new QGIS project.
save_projectSaves the current QGIS project.
path
get_project_infoRetrieves information about the current project.
add_vector_layerAdds a vector layer to the project.
pathname
add_raster_layerAdds a raster layer to the project.
pathname

Try It Out

After setup, try these prompts with your AI agent:

Create a new project and save it at '/tmp/my_project.qgz'
Load the vector layer '/data/cities.shp' and name it 'Cities'
Get field statistics for the 'population' field
Create a graduated symbology on the 'population' field with 5 classes
Render the map and show me the result
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
Alternative installation methods

Claude Desktop Config

Edit Claude Desktop config file

Keep this setup from going cold

Save the docs, env vars, and workflow around QGIS MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup