Install Godot MCP

Pick your client, copy the command, done.

claude mcp add godot-mcp -- python3 -m godot_mcp

Environment Variables

Set these before running Godot MCP.

VariableDescriptionRequired

GODOT_EXECUTABLEPath to the Godot engine binaryNo

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

godot_detect_executableLocates and validates the Godot executable.

godot_create_projectScaffolds a new Godot project.

godot_create_folderCreates project-relative folders.

godot_get_project_structureReturns project file structure.

godot_list_resourcesProvides a grouped overview of project resources.

godot_start_projectOpens the Godot editor for the project.

godot_create_sceneCreates and saves a new scene.

godot_create_shaderGenerates a .gdshader file.

godot_update_project_settingsEdits project settings parameters.

godot_attach_scriptAttaches or creates a script for a node.

godot_get_scene_treeInspects a scene's node tree structure.

godot_validate_sceneDry-run parses a scene resource.

godot_add_nodeAdds a new node to an existing scene.

godot_add_primitive_meshAdds a primitive mesh to a MeshInstance3D node.

godot_edit_primitive_meshModifies primitive mesh parameters.

godot_edit_sceneEdits scene nodes and transforms.

godot_get_node_propertiesReturns node property list and values.

godot_get_node_transformInspects node transform data.

godot_update_node_transformUpdates node transform fields.

godot_run_projectLaunches the project's main scene.

godot_run_sceneLaunches a specific scene.

godot_run_with_captureRuns a scene and captures output and errors.

godot_screenshotCaptures a frame from the running project.

godot_search_docsSearches cached Godot API documentation.

After setup, try these prompts with your AI agent:

→Create a new Godot project named 'MyGame' in the current directory.

→Add a new Sprite2D node to the main scene and attach a basic movement script.

→List all scenes in the project and validate the 'player.tscn' file for errors.

→Update the project window size to 1920x1080 and run the main scene.

→Search the Godot documentation for how to use the CharacterBody2D class.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed

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