Install Godot MCP Server

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.

Run this once before adding it to Claude Code.

npm install
npm run build

claude mcp add godot-mcp-server -- node /absolute/path/to/godot-mcp-server/dist/index.js

Replace any placeholder paths in the command with the real path on your machine.

Environment Variables

Set these before running Godot MCP Server.

VariableDescriptionRequired

GODOT_HOSTHost where Godot is runningNo

GODOT_PORTPort the MCP Bridge plugin listens onNo

Once configured, Godot MCP Server gives your AI agent access to:

godot_list_scenesList all open scenes

godot_get_scene_treeGet full node hierarchy

godot_get_nodeGet all properties of a specific node

godot_add_nodeAdd a new node to a scene

godot_remove_nodeRemove a node and its children

godot_set_node_propertySet one or more properties on a node

godot_reparent_nodeMove a node to a new parent

godot_instantiate_sceneAdd a .tscn as an instance in a scene

godot_save_sceneSave the current scene to disk

godot_read_scriptRead a .gd file

godot_write_scriptWrite/create a .gd file

godot_run_scriptExecute a GDScript expression in the editor

godot_list_filesList files in the project

godot_get_resourceGet metadata about a resource

godot_assign_resourceAssign a resource to a node property

godot_create_sceneCreate a new empty .tscn file

After setup, try these prompts with your AI agent:

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

→Read the player.gd script

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Node.js 18+ with npm/npx installed

Save the docs, env vars, and workflow around Godot MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.