godot-mcp

Launch Godot editor for a specific project

Run the Godot project and capture output

Get the current debug output and errors

Stop the currently running Godot project

Get the installed Godot version

List Godot projects in a directory

Retrieve metadata about a Godot project

Create a new Godot scene file

Add a node to an existing scene

Load a sprite into a Sprite2D node

Export a scene as a MeshLibrary resource

Save changes to a scene file

Get the UID for a specific file in a Godot project (for Godot 4.4+)

Update UID references by resaving resources (4.4+)

Screenshot the running game (returns base64 PNG)

Click at a position in the running Godot game window

Send a key press or input action to the running game

Move the mouse in the running Godot game

Get visible UI elements from the running game

Get scene tree structure of the running game

Execute GDScript in the running game. Use "return" for values.

Get a property value from any node in the running game by its path

Set a property on a node in the running game

Call a method on any node in the running game with optional arguments

Get node info: class, properties, signals, methods, children

Load a PackedScene and add it as a child of a node in the running game

Remove and free a node from the running game's scene tree

Switch to a different scene file in the running game

Pause or unpause the running game

Get performance metrics (FPS, memory, draw calls)

Wait N frames in the running game

Read scene file as JSON node tree (headless)

Modify node properties in a scene file (headless)

Remove a node from a scene file (headless)

Read project.godot as structured JSON

Modify a project.godot setting

List project files, optionally filtered by extension

Connect a signal from one node to a method on another node in the running game

Disconnect a signal connection in the running game

Emit a signal on a node in the running game, optionally with arguments

Control an AnimationPlayer node: play, stop, pause, or list animations

Tween a node property in the running game

Get all nodes belonging to a specific group in the running game

Find all nodes of a specific class type in the running game

Move a node to a new parent in the running game's scene tree

Attach a GDScript to a scene node (headless)

Create a .tres resource file (headless)

Read a text file from a Godot project

Create or overwrite a text file in a Godot project

Delete a file from a Godot project

Create a directory inside a Godot project

Get new push_error/push_warning messages since last call

Get new print output from the running game since last call

Hold a key down without auto-releasing

Release a previously held key

Send mouse scroll wheel event at position

Drag mouse between two points over N frames

Send gamepad button or axis input event

Create a new Godot project from scratch

Add, remove, or list autoloads in a Godot project

Add, remove, or list input actions and bindings

Create or modify export preset configuration

Get active camera position, rotation, and size

Move or rotate the active camera

Cast a ray and return collision results

Get audio bus layout and playing streams

Create a new node of any type at runtime

Set a shader parameter on a node's material

Play, stop, or pause an AudioStreamPlayer node

Set volume, mute, or solo on an audio bus

Query a navigation path between two points

Get or set cells in a TileMapLayer node

Add a collision shape to a physics body node

Get or set environment and post-processing settings

Add or remove a node from a group, or list groups

Create a Timer node with configuration

Configure GPUParticles2D/3D node properties

Create an animation with tracks and keyframes

Export a Godot project using a preset

Save or load node tree state as JSON

Configure physics body properties (mass, velocity, etc.)

Create a physics joint between two bodies

Get or set bone poses on a Skeleton3D node

Apply theme overrides to a Control node

Create or configure a SubViewport node

Draw debug lines, spheres, or boxes in 3D

HTTP GET/POST/PUT/DELETE with headers and body

WebSocket client connect/disconnect/send messages

ENet multiplayer create server/client/disconnect

Call or configure RPC methods on nodes

Simulate touch press/release/drag and gestures

Query pressed keys, mouse position, connected pads

Manage runtime InputMap actions and strength

List all signals on a node with connections

Await a signal with timeout and return args

Attach, detach, or get source of node scripts

Get/set window size, fullscreen, title, position

Get platform, locale, screen, adapter, memory info

Get/set Engine.time_scale and timing info

Set node process mode (pausable/always/disabled)