Skip to main content

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. Download qgis_listener_v<version>.zip from 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

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)

Source distribution for luiccian-qgis-mcp 0.1.1
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)

Table of built distributions (wheels) for luiccian-qgis-mcp 0.1.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page