QGIS MCP

MCP serverCommunity

125 tools that drive a running QGIS 3.28 to 4.x through a plugin from the official QGIS plugin repository. By Nicolas Karasiak.

414 starsUpdated 3 weeks agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: QGIS
How it connects: Drives a running copy of the tool
Access: Can modify models
Tool versions: QGIS 3.28 to 4.x (plugin repository lists 3.28.0 to 4.99.0)
Operating systems: Not stated in its documentation
Needs a QGIS licence: No
Transport: Local (stdio), Remote (HTTP)
AI clients documented: Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, VS Code, Windsurf, Zed, GitHub Copilot CLI, LM Studio, opencode
Licence: MIT AND GPL-2.0-or-later
Language: Python

What it can do

Covers layers, feature editing with commit and rollback, styling, labelling, print layouts and atlas export, PostgreSQL connections and SQL across layers.
Runs Processing algorithms in batches or as background jobs with no time limit, and builds .model3 Processing models from a structured description.
Takes project checkpoints you can roll back to, and exports a session's changes as a PyQGIS script you can replay.
Marks each tool as read-only, destructive or idempotent so your client can ask before risky calls; a compound mode cuts the 125 tools to 27 grouped ones.
Can address several open QGIS windows from one server registration.

Limitations

The plugin socket has no authentication unless you set a shared token, and execute_code runs any PyQGIS code.
The plugin and server versions must match; a newer server can send commands an older plugin rejects.
The server is installed from a GitHub archive with uvx, not from PyPI.

Install

In QGIS: Plugins > Manage and Install Plugins > search QGIS MCP > Install. Restart QGIS and click Start Server in the QGIS MCP dock widget.

Source: github.com/nkarasiak/qgis-mcp#1-install-the-qgis-plugin

claude mcp add -s user qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server

Source: github.com/nkarasiak/qgis-mcp#2-connect-your-coding-agent

codex mcp add qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server

Source: github.com/nkarasiak/qgis-mcp#2-connect-your-coding-agent

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from", "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Source: github.com/nkarasiak/qgis-mcp#2-connect-your-coding-agent

MCP servers and skills run code on your computer. Review the source before installing.

Skills that come with it

SkillCommunity

qgis-mcp-tools skill (QGIS MCP)by Nicolas Karasiak

A SKILL.md reference to every QGIS MCP tool, with its safety annotations, for agents working on the server.

414· updated 3 weeks ago

AI-generated models, drawings and results must be checked by a qualified engineer before use.