CAD & engineering / CONNECTION GUIDEQGIS MCP Servers for Claude Code, Codex & Cursor
A QGIS plugin and MCP server connect map data, processing and layout workflows.
Integration documentation MCP · Live app
A QGIS plugin and MCP server connect map data, processing and layout workflows.
Platforms: Windows, macOS, Linux
Claude Code · Documented
The maintainer documents Claude Code setup for this connection.
Codex · Documented
The maintainer documents Codex setup for this connection.
Cursor · Documented
The maintainer documents Cursor setup for this connection.
Requirements and limitations
A supported QGIS 3.28–4.x installation, uv and the companion plugin and server.
The plugin must be enabled in QGIS. Algorithm availability depends on installed processing providers.
MCP · Live app
A QGIS plugin connects project and processing operations to a Python MCP server.
Platforms: See documentation
Claude Code · MCP compatible
MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.
Codex · MCP compatible
MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.
Cursor · MCP compatible
MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.
Requirements and limitations
QGIS 3.x, Python 3.10+, uv and the companion QGIS plugin.
Requires the plugin in QGIS; arbitrary PyQGIS execution depends on the running application environment.
API · Live & file workflows
PyQGIS provides Python access through the console, plugins and standalone scripts.
Platforms: Windows, macOS, Linux
Claude Code · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Codex · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Cursor · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Requirements and limitations
QGIS Python bindings with the correct application paths and environment; live control needs an in-app script or plugin.
Standalone scripts and the QGIS console have different environments. An agent-facing bridge is not included.
MCP · Live app
A QGIS plugin with an MCP bridge for map analysis and project editing.
Platforms: Windows, macOS, Linux
Claude Code · Documented
The integration documentation explicitly names this client.
Codex · Documented
The integration documentation explicitly names this client.
Cursor · Documented
The integration documentation explicitly names this client.
Requirements and limitations
QGIS with the AgenticGIS plugin enabled; Python 3.9 or newer for the optional stdio proxy.
The local MCP server controls the open QGIS project; optional external services have separate requirements.
Compare connections
Compare how each route works, what it can do, and what you need to run it.
| Connection | Workflow and platform | Capabilities | Documented agents | Requirements and limitations |
|---|
QGIS MCP · processing & layouts
MCP | Live app
Windows, macOS, Linux | | Claude Code, Codex, Cursor | A supported QGIS 3.28–4.x installation, uv and the companion plugin and server.
The plugin must be enabled in QGIS. Algorithm availability depends on installed processing providers. |
|---|
QGIS MCP · PyQGIS bridge
MCP | Live app
See documentation | | See compatibility | QGIS 3.x, Python 3.10+, uv and the companion QGIS plugin.
Requires the plugin in QGIS; arbitrary PyQGIS execution depends on the running application environment. |
|---|
PyQGIS
API | Live & file workflows
Windows, macOS, Linux | | See compatibility | QGIS Python bindings with the correct application paths and environment; live control needs an in-app script or plugin.
Standalone scripts and the QGIS console have different environments. An agent-facing bridge is not included. |
|---|
AgenticGIS MCP
MCP | Live app
Windows, macOS, Linux | | Claude Code, Codex, Cursor | QGIS with the AgenticGIS plugin enabled; Python 3.9 or newer for the optional stdio proxy.
The local MCP server controls the open QGIS project; optional external services have separate requirements. |
|---|
How it works
MCP · Live app
Windows, macOS, Linux
Capabilities
Manage layers and features · Run processing algorithms · Create map layouts and atlases
Documented agents
Claude Code · Codex · Cursor
Requirements and limitations
A supported QGIS 3.28–4.x installation, uv and the companion plugin and server.
The plugin must be enabled in QGIS. Algorithm availability depends on installed processing providers.
How it works
MCP · Live app
See documentation
Capabilities
Inspect projects and layers · Run PyQGIS processing code
Documented agents
See compatibility
Requirements and limitations
QGIS 3.x, Python 3.10+, uv and the companion QGIS plugin.
Requires the plugin in QGIS; arbitrary PyQGIS execution depends on the running application environment.
How it works
API · Live & file workflows
Windows, macOS, Linux
Capabilities
Script projects, layers and processing
Documented agents
See compatibility
Requirements and limitations
QGIS Python bindings with the correct application paths and environment; live control needs an in-app script or plugin.
Standalone scripts and the QGIS console have different environments. An agent-facing bridge is not included.
How it works
MCP · Live app
Windows, macOS, Linux
Capabilities
Inspect and style layers · Run processing algorithms · Export map layouts
Documented agents
Claude Code · Codex · Cursor
Requirements and limitations
QGIS with the AgenticGIS plugin enabled; Python 3.9 or newer for the optional stdio proxy.
The local MCP server controls the open QGIS project; optional external services have separate requirements.
Questions before setup
Does one integration cover every workflow?
No such claim is made. Check the capability list, requirements and limitations of each route, then test a copy of a representative project.