Skip to main content
Glama

OmniBridge MCP

One MCP server. Every scriptable CAD, BIM and 3D app. Any AI model.

OmniBridge lets Claude, ChatGPT, Gemini, Cursor, Copilot or a local model work inside the design software on your PC: read the model, draw, edit, check, and look at the result. It speaks the Model Context Protocol, so any MCP client can use it.

 Claude / ChatGPT / Gemini / Cursor / local model
                    |  MCP (stdio or HTTP)
              OmniBridge server            5 tools, the same for every app
                    |
   +----------------+-----------------+----------------------+
   | in-app bridge  | automation      | the app's own channel|
   | (script runs   | (COM / .NET /   | (pyRevit Routes,     |
   |  inside)       |  JSON API)      |  Unreal remote exec) |
   +----------------+-----------------+----------------------+
   Blender, Rhino,   AutoCAD, SOLIDWORKS,  Revit, Unreal
   3ds Max, SketchUp Archicad, Navisworks,
   FreeCAD, Maya ... Inventor, Tekla ...

The idea

pyRevit gave Revit a door for scripts. Tapir did the same for Archicad. OmniBridge applies that one principle everywhere: do not wrap each app in hundreds of fixed tools; give the model a way to run a short script in the app, and a guide for writing that script well.

So the server has five tools, whatever the app:

Tool

What it does

cad_apps

lists every supported app and whether it is reachable right now

cad_skill

returns the scripting guide for one app: language, predefined names, units, recipes, traps

cad_read

runs a script that only inspects the model

cad_modify

runs a script that changes the model, as one undo step where the app allows

cad_screenshot

returns a picture of the app's viewport or window so the model can check its work

Reading and changing are separate tools on purpose: MCP clients can auto-approve the first and ask you before the second.

Related MCP server: Volith

Supported apps

"Tested" means the authors ran it end to end. Everything else is written against the vendor's documented API and needs a first real run: please report what you find.

App

How it connects

Script language

Status

AutoCAD (+ Civil 3D, Plant 3D, Map 3D, MEP)

COM automation, nothing to install

Python

Tested (AutoCAD 2024)

BricsCAD, ZWCAD, GstarCAD, nanoCAD

COM automation (AutoCAD-compatible)

Python

Untested

Revit

pyRevit extension (Routes)

Python (Revit API)

Tested (Revit 2026)

Archicad

JSON API + Tapir add-on

Python + ac helper

Tested (Archicad 29)

Navisworks Manage / Simulate

COM automation (legacy API)

Python

Experimental

Rhino 7 / 8 / 9 + Grasshopper

in-app Python bridge

Python

Untested

3ds Max 2021+

in-app pymxs bridge

Python + MAXScript

Untested

SketchUp 2021+

in-app Ruby bridge

Ruby

Untested

Blender 3.2+

add-on

Python (bpy)

Tested (Blender 5.2)

FreeCAD 0.21+

Mod folder bridge

Python

Untested

Autodesk Fusion

add-in

Python (adsk)

Untested

SOLIDWORKS

COM automation, nothing to install

Python

Tested (SOLIDWORKS 2025)

Inventor, CATIA V5, Solid Edge

COM automation

Python

Untested

MicroStation

COM automation

Python

Untested

Tekla Structures

Open API through pythonnet

Python

Untested

ETABS, SAP2000, Robot

COM automation

Python

Untested

Maya, Cinema 4D, Houdini

in-app Python bridge

Python

Untested

Unreal Engine 5

built-in Python remote execution

Python

Tested (UE 5.8)

QGIS 3.28+ / 4

plugin

Python (PyQGIS)

Untested

Not possible today (no scripting interface of any kind): Twinmotion, Lumion, D5 Render, Enscape, Shapr3D, Plasticity, AutoCAD LT (no external automation), Navisworks Freedom. Vectorworks, Allplan and NX only allow in-process plug-ins and are on the roadmap.

Install

Needs Windows and Python 3.10+ (uv recommended).

uv tool install git+https://github.com/ayoubmep/omnibridge-mcp

or from a clone:

pip install -e .

Check what it can see:

omnibridge apps

Connect your AI client

omnibridge config claude-desktop

prints the exact snippet for your machine. Replace the name with claude-code, cursor, vscode, gemini, codex, lmstudio, chatgpt or all. Details and caveats per client: docs/clients.md.

Connect your apps

Apps driven by automation (AutoCAD, SOLIDWORKS, Archicad, Tekla ...) need nothing: start the app and open a file.

Apps that need a bridge inside them get it with one command:

omnibridge install blender

Use rhino, 3dsmax, sketchup, freecad, fusion, maya, c4d, houdini, qgis, revit, or all for every app found on the PC. The command prints the one manual step some apps still need (ticking the add-on, pasting a startup line). omnibridge uninstall <app> removes it again.

Try it

Ask your AI client:

Use OmniBridge. Which CAD apps are open? In AutoCAD, draw a 6 x 4 m room on a new layer "A-WALL" with a 900 mm door opening on the south wall, then show me a screenshot.

More prompts, including cross-app ones: examples/prompts.md.

You can also drive an app from the terminal, which is handy for debugging:

omnibridge run autocad "result = {'file': doc.Name, 'entities': ms.Count}"

Safety

Giving an AI a script engine inside your design software is powerful. Treat it that way.

  • Local only. Bridges listen on 127.0.0.1 and refuse any request without the secret token stored in ~/.omnibridge/token. A web page cannot read that file and cannot talk to the bridge.

  • Scripts are not sandboxed. A script can do anything the app can do, including deleting geometry and writing files. Keep your client's approval prompt on for cad_modify, work on a copy of important models, and save before a session.

  • One undo step. Where the app supports it, each cad_modify is a single undo entry named after what the AI said it was doing.

  • HTTP mode is for trusted networks. omnibridge serve --transport http has no login of its own. If you expose it through a tunnel for ChatGPT, use a tunnel that requires authentication and stop it afterwards.

  • Revit: pyRevit Routes itself has no authentication; OmniBridge's endpoints check the token, other Routes endpoints on your machine do not.

How it works

  • docs/protocol.md: the wire protocol and how to add an app (about 60 lines of code for an app with a Python console).

  • docs/prior-art.md: the existing MCP servers for each app, the vendors' own servers, and how OmniBridge differs. If one app is all you need, one of those dedicated servers may suit you better.

  • docs/status.md: exactly what has been tested, and on what.

Credits

OmniBridge stands on the ideas of pyRevit, Tapir, blender-mcp, rhinomcp and the many projects listed in docs/prior-art.md. No code from them is included.

License

MIT. See LICENSE.

Available Tools

5 tools
cad_appsA
Read-onlyIdempotent

List every app OmniBridge supports and whether it is reachable right now.

Call this first. An app is usable when its state is "connected" or "running". When the state is "running, bridge not loaded", tell the user the next step. Set only_available to true to hide apps that are not running.

Inputs: only_available. Returns: result

cad_modifyA
Destructive

Run a script that CHANGES the app's open model (create, edit, delete, save).

Where the app supports it the whole script becomes one undo step, named by summary (a few words the user will see in the app's undo history). Same script rules as cad_read. Verify the result afterwards.

Inputs: app (required), code (required), summary, instance, +1 more. Returns: result

cad_readA
Read-only

Run a script that only INSPECTS the app's open model. Nothing may be changed.

app: an id from cad_apps, for example "blender", "autocad", "revit". code: the script, in the language given by cad_skill(app). Set result = ... (or end with an expression) to return data; printed text comes back too. instance: port of one instance when cad_apps lists several of the same app.

Inputs: app (required), code (required), instance, timeout_s. Returns: result

cad_screenshotA
Read-only

Capture the app's current viewport as an image so you can check your work.

Not every app supports this. When it fails, export an image with a script instead.

Inputs: app (required), width, height, instance.

cad_skillA
Read-onlyIdempotent

Return the scripting guide for one app: language, predefined names, units, how to return data, common recipes and traps. Read it before scripting an app.

Inputs: app (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: discovery, documentation, read-only execution, modifying execution, and visual verification. The read/modify split is explicitly differentiated by intent and side effects, leaving little chance of misselection.

    Naming Consistency4/5

    All tools share a consistent 'cad_' namespace and are concise and readable. However, the suffixes mix nouns (apps, skill, screenshot) with verbs (read, modify), so the pattern is not a pure verb_noun convention.

    Tool Count5/5

    Five tools is well-scoped for a CAD bridge: discover apps, read the scripting guide, inspect, modify, and visually verify. Each tool clearly earns its place with no redundant surface area.

    Completeness5/5

    The surface covers the full core workflow: app availability, scripting guidance, read-only inspection, model mutation with undo support, and screenshot verification. No obvious lifecycle gaps remain, and fallback paths are noted where capabilities vary by app.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Enables AI to interact with Revit via MCP, allowing data retrieval and element creation, modification, and deletion.
      13
      59 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to execute editable-3D design programs, inspect their geometry, and replay or revise native project files through MCP tools.
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants like Claude Desktop or Cursor to control supported CAD applications through MCP tools for drawing, layer, block, entity, data export, and file/session operations using natural language or direct tool calls.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants like Claude for Desktop or Cursor to control supported CAD applications through MCP, supporting drawing, layer and entity management, block operations, data export, and file/session control via natural language or unified tool calls.
      -