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 MCP server?

If you want an AI assistant working directly with Qgis MCP, the qgis mcp mcp server is the bridge. 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

Tools it exposes

Once connected, the assistant can call these 14 tools directly:

  • 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

Installing the qgis mcp mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

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

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Qgis MCP sits in that group, and the shape of its toolset — ping, get_qgis_info, load_project among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • With 14 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use Qgis MCP.
  • Maintained by jjsantos01, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the qgis mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

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

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

It connects Qgis MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (ping, get_qgis_info, load_project, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Qgis MCP directly.