How do I install the Qgis skill?

Run npx skillmds@latest add majiayu000/qgis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Qgis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Qgis by majiayu000 — Agent Skill

Name: Qgis
Rating: 4.5 (4 reviews)
Author: majiayu000

Qgis

Geospatial analysis and GIS operations via QGIS. Use for calculating distances, buffering zones, coordinate transforms (EPSG:4326 to EPSG:3857), layer operations, geoprocessing (intersect, union, clip), and exporting map images. Requires QGIS running on Display :1 with MCP plugin enabled.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

QGIS Skill

Geospatial analysis and GIS operations via FastMCP protocol, communicating with QGIS instance via TCP socket.

When to Use This Skill

Calculate distances between geographic points
Create buffer zones around features (proximity analysis)
Transform coordinates between CRS (GPS to Web Mercator)
Load and manipulate geospatial layers (Shapefile, GeoJSON, GeoPackage)
Perform geoprocessing operations (intersect, union, difference, clip)
Export map images for reports or web display
Query features with spatial filters
Style layers with categorized or graduated symbology

Architecture

┌─────────────────────────────┐
│  Claude Code / VisionFlow   │
│  (MCP Client)               │
└──────────────┬──────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────┐
│  QGIS MCP Server (FastMCP)  │
│  Port: stdio                │
└──────────────┬──────────────┘
               │ TCP Socket
               ▼
┌─────────────────────────────┐
│  QGIS Desktop (Display :1)  │
│  MCP Plugin on Port 9877    │
└─────────────────────────────┘

Tools

Tool	Description
`load_layer`	Load geospatial layer (Shapefile, GeoJSON, GeoPackage, WMS)
`buffer_analysis`	Create buffer zones around features
`calculate_distance`	Calculate distance between two points
`transform_coordinates`	Transform between coordinate systems
`export_map`	Export map view as PNG, JPG, or PDF
`query_features`	Query layer features with filter expression
`list_layers`	List all loaded layers
`set_layer_style`	Apply styling (simple, categorized, graduated)
`geoprocessing`	Intersect, union, difference, dissolve, clip
`get_layer_extent`	Get bounding box of a layer
`health_check`	Verify QGIS connection

Examples

# Load a GeoJSON layer
load_layer({
    "path": "/data/cities.geojson",
    "name": "Cities"
})

# Create 10km buffer around points
buffer_analysis({
    "layer_name": "Cities",
    "distance": 10000,  # meters
    "output_name": "city_buffers"
})

# Transform GPS coordinates to Web Mercator
transform_coordinates({
    "coordinates": [-122.4194, 37.7749],  # San Francisco
    "source_crs": "EPSG:4326",
    "target_crs": "EPSG:3857"
})

# Export map image
export_map({
    "output_path": "/output/map.png",
    "width": 1920,
    "height": 1080,
    "dpi": 150
})

Environment Variables

Variable	Default	Description
`QGIS_HOST`	`localhost`	QGIS MCP plugin host
`QGIS_PORT`	`9877`	QGIS MCP plugin port
`QGIS_TIMEOUT`	`60`	Socket timeout in seconds

Troubleshooting

Connection refused:

# Check QGIS is running on Display :1
supervisorctl status qgis

# Verify MCP plugin is loaded
# In QGIS: Plugins → Manage Plugins → Search "MCP"

VisionFlow Integration

This skill exposes qgis://capabilities and qgis://status resources for discovery by VisionFlow's MCP TCP client.

---name: qgisdescription: Geospatial analysis and GIS operations via QGIS. Use for calculating distances, buffering zones, coordinate transforms (EPSG:4326 to EPSG:3857), layer operations, geoprocessing (intersect, union, clip), and exporting map images. Requires QGIS running on Display :1 with MCP plugin enabled.--- # QGIS Skill Geospatial analysis and GIS operations via FastMCP protocol, communicating with QGIS instance via TCP socket. ## When to Use This Skill - Calculate distances between geographic points - Create buffer zones around features (proximity analysis) - Transform coordinates between CRS (GPS to Web Mercator) - Load and manipulate geospatial layers (Shapefile, GeoJSON, GeoPackage) - Perform geoprocessing operations (intersect, union, difference, clip) - Export map images for reports or web display - Query features with spatial filters - Style layers with categorized or graduated symbology ## Architecture ```text ┌─────────────────────────────┐ │ Claude Code / VisionFlow │ │ (MCP Client) │ └──────────────┬──────────────┘ │ MCP Protocol (stdio) ▼ ┌─────────────────────────────┐ │ QGIS MCP Server (FastMCP) │ │ Port: stdio │ └──────────────┬──────────────┘ │ TCP Socket ▼ ┌─────────────────────────────┐ │ QGIS Desktop (Display :1) │ │ MCP Plugin on Port 9877 │ └─────────────────────────────┘ ``` ## Tools | Tool | Description | | ----------------------- | ----------------------------------------------------------- | | `load_layer` | Load geospatial layer (Shapefile, GeoJSON, GeoPackage, WMS) | | `buffer_analysis` | Create buffer zones around features | | `calculate_distance` | Calculate distance between two points | | `transform_coordinates` | Transform between coordinate systems | | `export_map` | Export map view as PNG, JPG, or PDF | | `query_features` | Query layer features with filter expression | | `list_layers` | List all loaded layers | | `set_layer_style` | Apply styling (simple, categorized, graduated) | | `geoprocessing` | Intersect, union, difference, dissolve, clip | | `get_layer_extent` | Get bounding box of a layer | | `health_check` | Verify QGIS connection | ## Examples ```python # Load a GeoJSON layer load_layer({ "path": "/data/cities.geojson", "name": "Cities" }) # Create 10km buffer around points buffer_analysis({ "layer_name": "Cities", "distance": 10000, # meters "output_name": "city_buffers" }) # Transform GPS coordinates to Web Mercator transform_coordinates({ "coordinates": [-122.4194, 37.7749], # San Francisco "source_crs": "EPSG:4326", "target_crs": "EPSG:3857" }) # Export map image export_map({ "output_path": "/output/map.png", "width": 1920, "height": 1080, "dpi": 150 }) ``` ## Environment Variables | Variable | Default | Description | | -------------- | ----------- | ------------------------- | | `QGIS_HOST` | `localhost` | QGIS MCP plugin host | | `QGIS_PORT` | `9877` | QGIS MCP plugin port | | `QGIS_TIMEOUT` | `60` | Socket timeout in seconds | ## Troubleshooting **Connection refused:** ```bash # Check QGIS is running on Display :1 supervisorctl status qgis # Verify MCP plugin is loaded # In QGIS: Plugins → Manage Plugins → Search "MCP" ``` ## VisionFlow Integration This skill exposes `qgis://capabilities` and `qgis://status` resources for discovery by VisionFlow's MCP TCP client.

Frequently asked questions