speckle-mcp
This server connects AI agents to Speckle, enabling natural language management of BIM/CAD projects, models, and versions without transferring geometry data. It provides:
Project management: List all accessible projects with configurable limit (
speckle_projects_list), get project details including models and team (speckle_project_details), and create new projects with name, optional description, and visibility setting (speckle_project_create).Model management: List models within a project (
speckle_models_list), get model details including full version history with author, date, and commit messages (speckle_model_details), and create models categorized by discipline (e.g., Architecture, Structure) with optional description (speckle_model_create).Data transfer guidance: Obtain step-by-step, connector-specific instructions for sending data to Speckle from applications like Revit, Rhino, or AutoCAD (
speckle_send_instructions), and receive version info and guidance for pulling data into BIM apps or programmatic use (speckle_receive_instructions). These do not perform actual data transfer—they rely on native Speckle connectors.
Provides Speckle project and model management, with instructions for sending and receiving data via Archicad's Speckle connector.
Provides Speckle project and model management, with instructions for sending and receiving data via AutoCAD's Speckle connector.
Provides Speckle project and model management, with instructions for sending and receiving data via Blender's Speckle connector.
Provides Speckle project and model management, with instructions for sending and receiving data via QGIS's Speckle connector.
Provides Speckle project and model management, with instructions for sending and receiving data via SketchUp's Speckle connector.
Provides Speckle project and model management, with instructions for sending and receiving data via Unity's Speckle connector.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@speckle-mcplist all projects in my Speckle account"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
speckle-mcp
Connect Revit, Rhino, AutoCAD and more to AI agents. Manage projects, models and versions through natural language. Data flows through native Speckle connectors — this MCP provides instructions and metadata.
For Architects & Engineers
What does this do?
Instead of opening 4 different apps to check project status, ask Claude:
"Show me the latest model version in the Hospital project"
Claude connects to Speckle and tells you who sent what, when, and which discipline.
What can I ask?
You ask... | It does... |
"List my Speckle projects" | Shows all your projects with IDs and dates |
"What models are in project X?" | Lists architecture, structure, MEP models |
"Show me the version history" | Who sent what, when, with commit messages |
"Create a new project for the school" | Creates a project ready for your team |
"How do I send my Revit model?" | Step-by-step for Revit, Rhino, AutoCAD, Blender |
"How do I receive the latest model?" | Instructions for pulling data into your BIM tool |
How to install
Step 1: Install uv:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
curl -LsSf https://astral.sh/uv/install.sh | sh # MacStep 2: Get a free Speckle token at https://app.speckle.systems/profile
Step 3: Download and configure:
git clone https://github.com/Daviidro/speckle-mcp.git
cd speckle-mcp
uv syncAdd to Claude Desktop config:
{
"mcpServers": {
"speckle": {
"command": "uv",
"args": ["run", "speckle-mcp"],
"env": { "SPECKLE_TOKEN": "your-token-here" }
}
}
}Is this safe?
Yes. Your Speckle data is protected by your personal access token.
You control which projects the token can access
Revoke the token anytime from your Speckle profile
The token stays on your computer — never sent anywhere except Speckle servers
Open source (MIT) — inspect every line
Related MCP server: mcp-server-for-revit
For Developers
Tools
Tool | Description |
| List all accessible Speckle projects |
| Get project details, models, and team |
| Create a new Speckle project |
| List models in a project |
| Get model details with version history |
| Create a new model with discipline |
| Guidance for sending from Revit/Rhino/etc. |
| Version info + guidance for receiving |
Supported platforms
Speckle Server: app.speckle.systems or self-hosted
Connectors: Revit, Rhino, Grasshopper, AutoCAD, Archicad, Blender, SketchUp, Unity, Unreal, Power BI, QGIS, Excel
Ecosystem
ifcopenshell-mcp — Talk to IFC models
bim-agent — Multi-MCP orchestrator
awesome-aec-mcp — Curated MCP list
License
Maintenance
Related MCP Servers
- Alicense-qualityDmaintenanceAI-powered MCP server that enables Claude and other LLMs to interact directly with construction documents, drawings, and specifications through advanced RAG and hybrid search capabilities.7MIT
- Flicense-qualityCmaintenanceNode.js MCP server enabling AI assistants to interact with Autodesk Revit for model operations, data queries, and sketch-to-building generation via LLM.231
- Flicense-qualityCmaintenanceEnables natural language control of Autodesk Revit through an AI-powered MCP server, allowing creation of walls, rooms, floor plans, and dimensions using conversational commands.
- Flicense-qualityCmaintenanceMCP server that connects an LLM assistant to Autodesk Civil 3D via COM, enabling direct manipulation of surfaces, alignments, COGO points, layers, profiles, and more through natural language.
Related MCP Connectors
GibsonAI MCP server: manage your databases with natural language
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for generating rough-draft project plans from natural-language prompts.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Daviidro/speckle-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server