Install Better Godot MCP

Pick your client, copy the command, done.

claude mcp add better-godot-mcp -- npx -y @n24q02m/better-godot-mcp@latest

Environment Variables

Set these before running Better Godot MCP.

VariableDescriptionRequired

GODOT_PROJECT_PATHDefault project path for toolsNo

GODOT_PATHPath to the Godot binaryNo

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

projectManage project metadata, run/stop, settings, and exports.

actionproject_path

scenesManage scene files including creation, listing, and modification.

actionproject_pathscene_name

nodesManipulate nodes within the scene tree.

actionproject_pathnode_path

scriptsPerform CRUD operations on GDScript files.

actionproject_pathscript_path

shaderManage shader files with Godot 4 syntax support.

actionproject_pathshader_path

physicsConfigure collision layers and physics bodies.

actionproject_path

After setup, try these prompts with your AI agent:

→Create a new scene named 'Player' and add a CharacterBody2D node to it.

→List all GDScript files in my current project and read the contents of player.gd.

→Set up a new collision layer named 'Enemies' in my project physics settings.

→Add a new animation track to the existing AnimationPlayer in my main scene.

Prerequisites & system requirements

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

Alternative installation methods

docker run -i --rm n24q02m/better-godot-mcp:latest

Conare · memory for coding agents

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