Gerador de Ferramentas MCP para Revit
studioliquid-lab/revit-mcp-tool-generator
Crie ferramentas Revit falando com Claude, sem código
Ver no GitHubGera ferramentas MCP para Revit a partir de linguagem natural usando Claude e pyRevit, sem necessidade de código ou conhecimento da API. Descreva o que deseja, Claude cria, testa e instala a ferramenta automaticamente no seu projeto Revit.
Instalação
npx convez-ai studioliquid-lab/revit-mcp-tool-generator1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar tarefas repetitivas em modelos Revit via linguagem natural
- Gerar scripts para listar, filtrar e modificar elementos arquitetônicos
- Criar e compartilhar ferramentas customizadas com equipes de projeto
Veredito

Projeto experimental promissor que democratiza a automação em Revit para não-programadores. Funciona bem em Revit 2024, mas ainda carece de testes em versões anteriores e é adequado apenas para projetos de teste, não produção.
README
A tradução para o português deste README ainda está na fila.
revit-mcp-tool-generator
🇬🇧 English · 🇮🇹 Italiano
Build MCP tools for Revit by talking to Claude in plain language. No code, no Revit API knowledge needed — describe what you want, Claude builds it, tests it, installs it.
⚠️ Project Status
This is an experimental project in early stages (v0.1.0). We built it at Studioliquid to solve an internal workflow need at our studio, and decided to open source it to gather feedback from the Revit community.
What that means in practice:
- ✅ The 49 backend unit tests pass
- ✅ The end-to-end flow has been verified only on Revit 2024 with pyRevit Master
- ⚠️ NOT tested on other Revit versions (2022/2023/2025+). It might work, but no guarantees
- ⚠️ Bugs and edge cases are expected: not battle-tested
- ⚠️ Internal APIs and patterns may change in upcoming releases (
semver < 1.0) - ⚠️ Use on test projects first, not production models
Tested versions
| Component | Version tested |
|---|---|
| Revit | 2024 (build 2024.2) |
| pyRevit | Master (4.8.16+) |
| Python (host of the MCP server) | 3.11 / 3.14 |
| Operating system | Windows 11 |
If you try it on other versions, open an Issue and let us know how it went — good or bad experience is valuable to expand the compatibility matrix.
We're actively looking for feedback on:
- Bugs, crashes, Revit instability
- Tools that the skill can't generate (or generates incorrectly)
- Suggestions to improve the cookbook and templates
- Workflows and use cases you'd like to see supported
Open an Issue or join the Discussions.
What it does
In Claude, you write (in any language):
I want a tool that lists all walls on the active level with their thickness in millimeters.
Claude:
- Checks whether a similar tool already exists
- Generates pyRevit handler code + MCP manifest
- Validates the code via pyRevit
- Installs it in your personal library
- Tests it immediately on the open Revit project
- Shows you the result
20-40 seconds from prompt to working, persistent, reusable tool — shareable with colleagues.
Examples of tools you can generate
- "Count the elements in my current selection and tell me their categories"
- "List the doors on the active level with their dimensions"
- "On the selected walls, set the comment to the text I pass"
- "Delete walls below a given height — show me a preview first"
Architecture
┌──────────────────────┐ MCP ┌──────────────────────┐ HTTP ┌────────────────────┐
│ Claude (Code/Desktop)│ ◀─stdio─▶ │ revit-mcp-server │ ◀──REST───▶ │ Revit + pyRevit │
│ + skill │ │ (local Python) │ │ (Routes server) │
└──────────────────────┘ └──────────────────────┘ └────────────────────┘
↓ ↑
"I want a tool that..." ~/.revit-mcp/tools/
(global library)
Three components, each with a single responsibility:
- pyRevit extension
RevitMcpRoutes— exposes HTTP routes inside Revit for managing the tool library revit-mcp-server(Python) — MCP server that proxies between Claude and pyRevit- Skill
revit-mcp-tool-generator— markdown content that teaches Claude how to generate safe, working tools
Generated tools are (manifest.json, handler.py) pairs saved both in ~/.revit-mcp/tools/ (user library) and in RevitMcpRoutes.extension/lib/revit_mcp_routes/tools/.
Install
Five minutes on Windows.
Prerequisites
- Windows 10/11 with PowerShell 5+
- Revit 2024 ⚠️ (the only tested version; other versions may work but are not officially supported)
- pyRevit 4.8+ (download)
- Python 3.11+ (download)
- Claude Code (CLI) or Claude Desktop App (download)
Quick install
- Download the latest release from the Releases page (a single
.zip) - Extract to a stable folder (e.g.
C:\Tools\revit-mcp-tool-generator\) - Double-click
setup.bat - Restart Revit + Claude
- In Claude write: "Use the sample_read tool and tell me how many walls you find" → verify it works
Detailed instructions: see INSTALL.md (Italian) — English translation coming soon.
Sharing tools with the community
Each tool is two files. To package it:
.\export-tool.ps1 -Name list_walls_by_level
Output: list_walls_by_level.tool.zip (~1-2 KB), shareable via email/cloud. A colleague imports it with:
.\import-tool.ps1 -Zip "list_walls_by_level.tool.zip"
The import script validates the tool on the destination machine before installing.
Known limitations
- Windows only: Revit only runs on Windows
- Hot-reload of new tools in Claude Desktop App: client-side limitation (Code CLI works perfectly, Desktop App requires restart after each new tool)
- Single Revit version per install: to change Revit version, edit
~/.revit-mcp/config.tomlor re-runsetup.bat - Python 3.11+ required for the MCP server (pyRevit uses IronPython 2.7 but is handled automatically)
Documentation
| Document | Content |
|---|---|
INSTALL.md | Installation guide and troubleshooting (Italian) |
docs/user/setup.md | Quickstart |
docs/user/portable-skill.md | Use the skill with non-Claude agents (ChatGPT, Cursor, etc.) |
docs/user/install-extension.md | Manual installation of the pyRevit extension only |
docs/user/configure-claude-code.md | Manual Claude Code configuration |
revit-mcp-tool-generator/SKILL.md | Skill content (entry point for Claude) |
revit-mcp-tool-generator/references/cookbook.md | 15 tested pyRevit patterns |
revit-mcp-tool-generator/references/api-quickref.md | Revit API quick-reference |
Note: Most internal documentation is currently in Italian. PRs translating docs to English are very welcome.
Contributing
See CONTRIBUTING.md. The most valuable contributions are:
- Issues describing tools the skill cannot generate
- Pull requests adding patterns to the cookbook
- Use case stories in Discussions: what works well, what doesn't, what's missing
Roadmap
See CHANGELOG.md for release history and intent.
Areas of future exploration (ordered by likelihood):
- v0.2: local LLM wiki of Revit docs (replaces on-demand WebFetch, works offline)
- v0.3: simultaneous multi-version Revit
- v0.4: composite tools (macros that call other tools)
- v1.0: API stabilization + community tool marketplace
License
MIT — copyright © 2026 Studioliquid
See NOTICE.md for third-party software credits and trademark attributions (Autodesk® Revit®, Anthropic Claude™, pyRevit, Python packages used at runtime).
Built and maintained by Studioliquid — an Italian studio working at the intersection of architecture, BIM, and AI.