# twinmotion

Connect an agent to Twinmotion to bring in Revit models, adjust scene conditions, render stills, and export walkthrough videos.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ScanBIM-Labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ScanBIM-Labs/twinmotion-mcp
- Updated: 2026-04-21
- HTML: https://affpapa.org/en/nevibecode/mcp/twinmotion

## What it does

The server exposes five Twinmotion tools. It can import a Revit model, change weather and time of day, render a still image, export a video as MP4, MOV, or WebM, and show saved scenes and animations. Still renders can reach 8K.

It runs on Cloudflare Workers and authenticates through APS OAuth2. You need a ScanBIM user key, sent either in the `x-scanbim-api-key` header or as a Bearer token. Pick one format and keep using it: switching formats creates a separate free-plan account with 50 credits.

## Requirements
- Remote server: `https://mcp.scanbimlabs.io/twinmotion`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http twinmotion https://mcp.scanbimlabs.io/twinmotion
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add twinmotion --url https://mcp.scanbimlabs.io/twinmotion
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "twinmotion": {
            "url": "https://mcp.scanbimlabs.io/twinmotion"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "twinmotion": {
            "type": "http",
            "url": "https://mcp.scanbimlabs.io/twinmotion"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http twinmotion https://mcp.scanbimlabs.io/twinmotion
```

## When to use it
- bring a Revit model into Twinmotion
- set weather and time of day for a scene
- render a still image at up to 8K
- export a walkthrough as MP4, MOV, or WebM
- inspect saved scenes and animations

## Example prompts
- Import the Revit model into Twinmotion and prepare the scene.
- Change the weather and time of day, then render a still image.
- Export a walkthrough video in MP4 format.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md