Godot AI MCP Server: Setup for Claude Code, Cursor and Other Apps

• Checks which Godot project and scene is open and whether the editor is ready

  Reports the editor version, project name, open scene and whether a game is running. Good first call so the assistant knows what it is working with.

  Try: “What project and scene do I have open in Godot right now?”

  Read · editor_state

• Lists the nodes in the open scene as a tree

  Walks the scene tree a page at a time, so large scenes do not flood the chat.

  Try: “Show me the current scene hierarchy.”

  Read · scene_get_hierarchy

• Shows every setting on one node

  Returns the full set of properties for a node you point to, such as position, size or script.

  Try: “What are the properties of /Main/Player?”

  Read · node_get_properties

• Picks which open Godot editor to talk to

  When more than one editor is connected, this fixes which one later calls go to.

  Try: “Switch to the editor that has my platformer project open.”

  Write · session_activate

• Runs several editor changes as one all-or-nothing step

  Sends a list of editor commands together and undoes them all if one fails.

  Try: “Create a Player node, add a sprite and a collision shape, all in one go.”

  Write · batch_execute

• Adds a new node to the scene

  Creates a node of a chosen type under a parent node.

  Try: “Create a Camera3D named MainCamera under /Main.”

  Write · node_create

• Changes a setting on a node

  Sets one property on a node, such as its position, color or text.

  Try: “Set the Player's speed to 300.”

  Write · node_set_property

• Finds nodes by name, type or group

  Searches the open scene for matching nodes.

  Try: “Find every node in the enemies group.”

  Read · node_find

• Opens a scene file in the editor

  Loads a scene from your project into the editor.

  Try: “Open res://levels/level_1.tscn.”

  Write · scene_open

• Saves the open scene

  Writes the current scene back to its file.

  Try: “Save the scene.”

  Write · scene_save

• Creates a new script file

  Writes a new script into your project. GDScript is checked for errors. C# files are written as plain text only.

  Try: “Create a player movement script with WASD controls.”

  Write · script_create

• Attaches a script to a node

  Links an existing script file to a node in the scene.

  Try: “Attach player.gd to the Player node.”

  Write · script_attach

• Edits part of a script

  Changes a script by anchoring on text that is already there, instead of rewriting the whole file.

  Try: “In player.gd, change the jump height to 400.”

  Write · script_patch

• Plays the game and checks it started

  Starts the project and waits briefly to see whether the game came up, reporting any errors that appear.

  Try: “Run the project and tell me if it crashes.”

  Runs code · project_run

• Runs your GDScript test suites in the editor

  Runs the test suites in your project and returns pass and fail results.

  Try: “Run the scene test suite.”

  Runs code · test_run

• Reads the editor, game or plugin logs

  Returns recent log lines, including script parse errors and warnings from the editor.

  Try: “Read the editor errors and tell me why my script will not load.”

  Read · logs_read

• Takes a picture of the editor or the running game

  Captures the 3D view, the 2D view, a camera render or the running game window.

  Try: “Take a screenshot of the 3D viewport.”

  Read · editor_screenshot

• Restarts the Godot AI add-on

  Reloads the add-on and waits for it to reconnect.

  Try: “Reload the Godot AI plugin.”

  Runs code · editor_reload_plugin

• Creates an animation clip

  Adds a new animation, and sets up an animation player if the scene has none.

  Try: “Create an animation called idle on the Player.”

  Write · animation_create

• Creates scenes, saves under a new name, or lists scene roots

  Rolls up scene actions: create a scene, save a copy under a new path, or list root nodes.

  Try: “Create a new Node3D scene at res://levels/test.tscn.”

  Write · scene_manage

• Edits the node tree: move, rename, group or delete nodes

  Covers listing children and groups, duplicating, renaming, moving and reparenting nodes, adding them to groups and deleting them.

  Try: “Delete the old Enemy node and rename Boss to FinalBoss.”

  Delete · node_manage

• Reads a script, detaches it, or outlines its symbols

  Returns a script file's text, removes a script from a node, or lists the functions and variables in GDScript and C# files.

  Try: “List the functions in player.gd.”

  Write · script_manage

• Stops the game and edits project settings

  Stops a running game, reads or changes project settings, and sets the main scene.

  Try: “Set the main scene to res://main.tscn.”

  Write · project_manage

• Controls the editor: selection, monitors, logs, quit, game code

  Reads or sets the selection, shows performance monitors, clears logs, quits the editor, and can run a GDScript snippet inside the running game.

  Try: “Evaluate player.health in the running game.”

  Runs code · editor_manage

• Lists the connected Godot editors

  Shows which editor sessions are connected.

  Try: “List the Godot editors that are connected.”

  Read · session_manage

• Fetches the latest test results

  Returns the results of the most recent test run.

  Try: “Show the results of the last test run.”

  Read · test_manage

• Builds and plays animations

  Creates players, adds property and method tracks, sets autoplay, plays or stops, and applies fade, slide, shake and pulse presets.

  Try: “Add a fade-in animation to the title label.”

  Delete · animation_manage

• Creates and edits materials and shaders

  Creates materials, sets parameters, assigns them to nodes, applies presets, and edits shaders and visual shader graphs.

  Try: “Make a red glossy material and apply it to the Cube.”

  Write · material_manage

• Sets up and plays audio

  Creates audio players, assigns streams, changes playback settings and plays or stops sounds.

  Try: “Add an audio player to the Player and play footsteps.ogg.”

  Write · audio_manage

• Creates and tunes particle effects

  Creates particle nodes, sets their main and process settings and draw pass, restarts them and applies presets.

  Try: “Add a fire particle effect at the torch.”

  Write · particle_manage

• Creates and configures cameras

  Adds cameras, sets limits and damping for 2D, makes a camera follow a target and applies presets.

  Try: “Make the 2D camera follow the Player with smoothing.”

  Write · camera_manage

• Lists, connects and disconnects signals

  Shows a node's signals and links or unlinks them to methods.

  Try: “Connect the button's pressed signal to _on_start_pressed.”

  Delete · signal_manage

• Edits the project's input actions

  Lists actions, adds or removes them, and binds keys, mouse or gamepad events to them.

  Try: “Add a jump action bound to Space.”

  Delete · input_map_manage

• Inspects and plays the running game

  Reads the live scene tree and UI, pauses and resumes the game, steps a frame, and sends key, mouse, gamepad and action input.

  Try: “Press the jump key in the running game and tell me what happened.”

  Write · game_manage

• Lists, adds or removes autoload scripts

  Manages the scripts Godot loads automatically at game start.

  Try: “Add game_state.gd as an autoload.”

  Delete · autoload_manage

• Reads, writes, moves and removes project files

  Reads and writes text files, rescans and reimports assets, searches, moves, renames and deletes files inside your project.

  Try: “Move the old sprites into res://archive.”

  Delete · filesystem_manage

• Builds UI themes

  Creates themes and sets colors, sizes, fonts, icons and style boxes on them.

  Try: “Make a dark theme with rounded buttons.”

  Write · theme_manage

• Lays out and styles UI controls

  Sets anchors, text and rich text, builds layouts from a description, and draws simple recipes.

  Try: “Build a main menu with Play, Options and Quit buttons.”

  Write · ui_manage

• Finds, inspects, creates and assigns resources

  Searches and loads resources, creates curves, environments, collision shapes and textures, and assigns them to nodes.

  Try: “Generate a collision shape for the Rock mesh.”

  Write · resource_manage

• Looks up Godot class documentation

  Returns properties, methods and signals for a Godot class.

  Try: “What signals does the Area2D class have?”

  Read · api_manage

• Checks and sets up AI client connections

  Shows whether supported AI clients are configured for Godot AI, and adds or removes their entries.

  Try: “Check which AI clients are set up for Godot.”

  Write · client_manage

• Paints and reads tilemap cells

  Sets single cells or rectangles, clears the map and reads used cells.

  Try: “Fill a 10 by 5 rectangle with the grass tile.”

  Delete · tilemap_manage

• Reads tile atlases

  Lists the tiles in an atlas and returns the atlas image.

  Try: “Show me the tiles in the terrain tileset.”

  Read · tileset_manage

• Edits 3D grid maps

  Places items, fills areas, clears cells and lists the library.

  Try: “Fill the floor with stone blocks.”

  Delete · gridmap_manage

• Bakes navigation and finds paths

  Bakes a navigation mesh and returns a path between two points.

  Try: “Bake navigation for the level.”

  Write · navigation_manage

• Creates and combines CSG shapes

  Creates CSG shapes and sets how they combine, such as union or subtract.

  Try: “Cut a doorway into the wall with a CSG box.”

  Write · csg_manage

• Lists and runs custom tools from other add-ons

  Calls tools that other Godot add-ons registered with Godot AI.

  Try: “List the custom tools my add-ons added.”

  Runs code · custom_manage

Watch out for

• It can delete nodes, files and autoloads

  Node, file, tilemap, input and autoload tools can remove things from your project. Keep the project in Git so you can restore anything it removes. github.com

• It can run code inside your game

  One editor action runs a GDScript snippet in the running game, and the test tool runs your test suites. Use it on projects you trust. github.com

• Sends anonymous usage telemetry

  The README says it records an install ID, event, outcome, duration, platform and version, never code or file names. Opt out with the setting the README describes. github.com

• Writes stay inside your project

  The README says writes are confined to the project, and project.godot, override.cfg and .godot/ are off-limits. github.com

Security advisories