OmniBridge MCP
Allows AI clients to run Python scripts inside Archicad via its JSON API and Tapir add-on, enabling BIM model inspection, element creation or modification, and screenshot capture.
Provides COM automation for AutoCAD and its vertical products, enabling scripted reading and editing of drawings and screenshots, with changes grouped as a single undo step where supported.
Connects to Blender through an add-on so AI can execute bpy scripts to inspect scenes, edit objects and geometry, and take viewport screenshots.
Uses an in-app Python bridge to let AI query and modify Cinema 4D scenes and capture screenshots.
Installs a Mod folder bridge to run Python scripts in FreeCAD, supporting model inspection, parametric edits, and visual verification.
Provides an in-app Python bridge for scripting Houdini scene inspection, procedural or geometry changes, and screenshots.
Uses COM automation to run Python scripts in MicroStation for reading and modifying designs and capturing views.
Integrates through a QGIS plugin to run PyQGIS scripts, enabling project and layer inspection, edits, and map screenshots.
Uses an in-app Ruby bridge to execute scripts in SketchUp for model inspection, geometry editing, and viewport screenshots.
Connects via Unreal Engine’s built-in Python remote execution, allowing AI to inspect and modify levels or scenes and capture screenshots.
Click on "Deploy 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., "@OmniBridge MCP list my open CAD apps, then screenshot the Revit viewport"
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.
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 |
| lists every supported app and whether it is reachable right now |
| returns the scripting guide for one app: language, predefined names, units, recipes, traps |
| runs a script that only inspects the model |
| runs a script that changes the model, as one undo step where the app allows |
| 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 + | 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-mcpor from a clone:
pip install -e .Check what it can see:
omnibridge appsConnect your AI client
omnibridge config claude-desktopprints 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 blenderUse 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.1and 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_modifyis a single undo entry named after what the AI said it was doing.HTTP mode is for trusted networks.
omnibridge serve --transport httphas 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 toolscad_appsARead-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_modifyADestructive
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_readARead-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_screenshotARead-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_skillARead-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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Set up and run your firm's Precision AI agents, skills and routines from any MCP client.
Direct AI video, image, music and storyboard production from any MCP client.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables AI to interact with Revit via MCP, allowing data retrieval and element creation, modification, and deletion.1359 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to execute editable-3D design programs, inspect their geometry, and replay or revise native project files through MCP tools.1Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- FlicenseNot gradedqualityAmaintenanceEnables 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.-