Luiccian QGIS MCP (luiccian-qgis-mcp)
Model Context Protocol (MCP) server for controlling QGIS (3.28–4.x) from AI coding agents (Antigravity, Claude Code, Claude Desktop, and any MCP-compatible client).
Note — Two separate components: This PyPI package (
luiccian-qgis-mcp, Apache-2.0) provides only the MCP server (src/qgis_mcp). To connect to QGIS, you also need the companion Luiccian QGIS Listener plugin (qgis_listener, GPL-2.0-or-later) installed inside QGIS. Downloadqgis_listener_v<version>.zipfrom GitHub Releases and install it via Plugins → Manage and Install Plugins → Install from ZIP.
Architecture
AI Agent <--MCP (stdio / HTTP)--> luiccian-qgis-mcp (PyPI) <--TCP :9878--> QGIS Listener Plugin
Quick Start
Requires Python 3.12+ and uv.
Run directly without installing globally:
uvx luiccian-qgis-mcp
Or install into an environment:
pip install luiccian-qgis-mcp
luiccian-qgis-mcp
MCP Client Configuration
Add the following to your MCP client configuration (e.g., ~/.gemini/antigravity/mcp_config.json, Claude Desktop, or .mcp.json):
{
"mcpServers": {
"qgis": {
"command": "uvx",
"args": ["luiccian-qgis-mcp"]
}
}
}
For Claude Code:
claude mcp add -s user qgis -- uvx luiccian-qgis-mcp
Capabilities
128 MCP tools (or 27 grouped tools with QGIS_MCP_TOOL_MODE=compound) covering:
- Project & Session: info, load/save, checkpoints, session replay export
- Layers & Tree: vector, raster, web/XYZ/WMS, memory layers, joins, groups, ordering
- Features & Editing: query, spatial/attribute selection, add/update/delete, buffered edit sessions, undo/redo
- Processing & Raster: run algorithms, background jobs, raster calculator, zonal statistics, spatial joins
- Styling & Layouts: symbology, QML styles, print layouts, legends, scalebars, atlas export, map & 3D rendering
- Database Connections & Python: saved PostgreSQL/GeoPackage/SpatiaLite connections, cross-layer SQL,
execute_code
Environment Variables
| Variable | Default | Description |
|---|---|---|
QGIS_MCP_HOST |
localhost |
Host where the QGIS Listener plugin is running |
QGIS_MCP_PORT |
9878 |
TCP port of the QGIS Listener plugin |
QGIS_MCP_INSTANCES |
(unset) | Comma-separated name=port / name=host:port list for multiple QGIS windows |
QGIS_MCP_TOKEN |
(unset) | Shared auth token (overrides the token file written by the QGIS plugin) |
QGIS_MCP_TOOL_MODE |
granular |
granular (128 tools) or compound (27 grouped tools) |
QGIS_MCP_TRANSPORT |
stdio |
stdio or streamable-http |
Links
- Source & Full Documentation: https://github.com/LuiccianDev/qgis-mcp
- QGIS Plugin Releases: https://github.com/LuiccianDev/qgis-mcp/releases
- Issues: https://github.com/LuiccianDev/qgis-mcp/issues
Metadata
Release files for luiccian-qgis-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| luiccian_qgis_mcp-0.1.1.tar.gz | 199.2 kB | With provenance | Details for luiccian_qgis_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| luiccian_qgis_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for luiccian_qgis_mcp-0.1.1-py3-none-any.whl |
Total release size: 293.6 kB
Release files / luiccian_qgis_mcp-0.1.1.tar.gz
| Download URL | luiccian_qgis_mcp-0.1.1.tar.gz |
|---|---|
| Size | 199.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f00d84dfa01405f29f8a8d786d986293720faa6ed2aa613c5ec5a868f53b94b4
|
|
BLAKE2b-256 checksum How to use checksums |
2568cbb2c3262b57733248dce9eec553607622118e9af907d9978f65de65bdd7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logRelease files / luiccian_qgis_mcp-0.1.1-py3-none-any.whl
| Download URL | luiccian_qgis_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 94.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6675da336aa32f0c24c56ecaca5c211760ff44cdb3b726083887817184360204
|
|
BLAKE2b-256 checksum How to use checksums |
98842120737c9ed073cb8c5859050fa67f88a200c8b8f6a20b6af259028869fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logSecurity for luiccian-qgis-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for luiccian_qgis_mcp-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.