Skip to main content
Glama

speckle-mcp

License: MIT Python 3.10+ MCP Compatible

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               # Mac

Step 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 sync

Add 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

speckle_projects_list

List all accessible Speckle projects

speckle_project_details

Get project details, models, and team

speckle_project_create

Create a new Speckle project

speckle_models_list

List models in a project

speckle_model_details

Get model details with version history

speckle_model_create

Create a new model with discipline

speckle_send_instructions

Guidance for sending from Revit/Rhino/etc.

speckle_receive_instructions

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

License

MIT — built on Speckle (Apache 2.0) and MCP.

Available Tools

8 tools
speckle_model_createA

Create a new model within a Speckle project, organized by discipline (Architecture, Structure, etc.).

Inputs: name (required), project_id (required), discipline, description. Returns: result

speckle_model_detailsA

Get detailed model info including full version history with author, date, and commit messages.

Inputs: model_id (required), project_id (required). Returns: result

speckle_models_listA

List all models in a Speckle project. Models hold versioned BIM/CAD data from connectors.

Inputs: project_id (required), limit. Returns: result

speckle_project_createB

Create a new Speckle project to organize models shared across your team.

Inputs: name (required), visibility, description. Returns: result

speckle_project_detailsA

Get detailed information about a Speckle project, including its models and team members.

Inputs: project_id (required). Returns: result

speckle_projects_listB

List all accessible Speckle projects for the authenticated user. Projects are top-level containers that hold models.

Inputs: limit. Returns: result

speckle_receive_instructionsA

Get version info and instructions for receiving Speckle data into BIM applications or Python. Does NOT pull objects — use native connectors or specklepy operations.receive() for data retrieval.

Inputs: model_id (required), project_id (required), version_id. Returns: result

speckle_send_instructionsA

Get connector-specific instructions for sending BIM data to Speckle. Returns guidance for Revit, Rhino, AutoCAD, etc. Does NOT transfer data — use native Speckle connectors for actual data push.

Inputs: model_id (required), project_id (required), message. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct resource (project vs model) and action (list/details/create), with send/receive instructions clearly separated. No two tools overlap in purpose; descriptions clarify any potential confusion between list and details.

    Naming Consistency4/5

    All tools use a 'speckle_' prefix with resource and action, but pluralization is inconsistent (e.g., speckle_projects_list vs speckle_project_details) and the instruction tools use a verb-first pattern (speckle_send_instructions, speckle_receive_instructions). Overall pattern is readable and predictable.

    Tool Count5/5

    8 tools is well-scoped for a server focused on project and model management plus data transfer instructions. Each tool serves a clear purpose without redundancy or excessive bloat.

    Completeness3/5

    The set provides create, list, and details for both projects and models, but lacks update and delete operations, leaving the lifecycle incomplete. Actual data transfer is not included, only instructions, which is a noted gap but perhaps intentional given the description.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-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.
      8
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language control of Autodesk Revit through an AI-powered MCP server, allowing creation of walls, rooms, floor plans, and dimensions using conversational commands.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that lets users query, validate, convert, and compare IFC/BIM files using natural language. Runs fully locally and integrates with AI agents like Claude.
      8
      MIT