Godot MCP Server

Godot MCP Server

Connect Claude to your Godot 4 project. Claude can read and manipulate scenes, nodes, scripts, and assets directly in your editor.

Architecture

Claude (claude.ai)
    │  MCP (stdio)
    ▼
godot-mcp-server  (Node.js, runs locally)
    │  HTTP  localhost:9080
    ▼
MCP Bridge Plugin  (GDScript, runs inside Godot editor)
    │
    ▼
Godot Editor

Setup

1. Install the MCP Server

cd godot-mcp-server
npm install
npm run build

2. Install the Godot Plugin

Copy the godot-plugin/addons/mcp_bridge folder into your Godot project's addons/ directory:

your-godot-project/
└── addons/
    └── mcp_bridge/
        ├── plugin.cfg
        ├── mcp_bridge.gd
        └── mcp_http_server.gd

Then in Godot: Project → Project Settings → Plugins → enable MCP Bridge.

You should see: [MCP Bridge] Listening on http://127.0.0.1:9080 in the Output panel.

3. Configure Claude

Add to your Claude MCP config (claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp-server/dist/index.js"],
      "env": {
        "GODOT_PORT": "9080"
      }
    }
  }
}

Environment Variables

Available Tools

Scene Tools

Script Tools

Asset / Filesystem Tools

Example Prompts

Once connected, you can ask Claude things like:

• "Show me the scene tree of the current scene"
• "Add a Sprite2D called PlayerSprite as a child of /root/Main/Player"
• "Set the position of the Enemy node to (400, 300)"
• "Instantiate res://enemies/goblin.tscn under /root/Level at position (200, 150)"
• "List all .tscn files in the project"
• "Read the player.gd script"
• "Create a new scene at res://levels/level2.tscn with a Node2D root"

Notes

• The MCP Bridge plugin must be active and Godot must be open for any tools to work.
• godot_run_script executes arbitrary GDScript — use with care.
• Scene edits are live in the editor but not saved automatically. Use godot_save_scene to persist changes.
• The plugin binds to 127.0.0.1 only (no external access).