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

Variable	Default	Description
GODOT_HOST	127.0.0.1	Host where Godot is running
GODOT_PORT	9080	Port the MCP Bridge plugin listens on

---

Available Tools

Scene Tools

Tool	Description
godot_list_scenes	List all open scenes
godot_get_scene_tree	Get full node hierarchy
godot_get_node	Get all properties of a specific node
godot_add_node	Add a new node to a scene
godot_remove_node	Remove a node and its children
godot_set_node_property	Set one or more properties on a node
godot_reparent_node	Move a node to a new parent
godot_instantiate_scene	Add a .tscn as an instance in a scene
godot_save_scene	Save the current scene to disk

Script Tools

Tool	Description
godot_read_script	Read a .gd file
godot_write_script	Write/create a .gd file
godot_run_script	Execute a GDScript expression in the editor

Asset / Filesystem Tools

Tool	Description
godot_list_files	List files in the project
godot_get_resource	Get metadata about a resource
godot_assign_resource	Assign a resource to a node property
godot_create_scene	Create a new empty .tscn file

---

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).