godot-mcp

Overview

Godot MCP is a comprehensive Model Context Protocol server that provides AI assistants with full control over the Godot game engine. It features 149 tools covering networking, 3D/2D rendering, UI controls, audio effects, animation trees, file I/O, runtime code execution, property inspection, scene manipulation, signal management, physics, project creation, and more. The server builds upon and extends the original godot-mcp project, significantly expanding from 20 to 149 tools with substantial enhancements including runtime code execution, node inspection, animation control, and headless scene operations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• game_eval

  Execute arbitrary GDScript code in the running game with return values

  Try:Execute this GDScript code and return the resultTry:Run the following async code in the game engineTry:Evaluate this script expression and show the output
• game_get_property

  Read any property on any node by path in the running game

  Try:Get the position property of the player nodeTry:Read the health value from the enemy characterTry:Show the current scene's background color
• game_set_property

  Write any property on any node by path in the running game

  Try:Set the player's position to coordinates (100, 50)Try:Change the enemy's health to zeroTry:Update the main scene's background to blue
• game_call_method

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

  Try:Call the jump method on the player nodeTry:Trigger the attack function with damage value 50Try:Run the spawn_enemy method with position (200, 300)
• game_instantiate_scene

  Dynamically add scenes to the running game

  Try:Instantiate the bullet scene at the player's positionTry:Add a new enemy to the sceneTry:Load and display the explosion effect
• game_play_animation

  Control AnimationPlayer in the running game

  Try:Play the idle animation on the characterTry:Pause the current animation sequenceTry:List all available animations in the AnimationPlayer
• game_pause

  Pause or unpause the running game

  Try:Pause the gameTry:Unpause the gameTry:Toggle the game's paused state
• read_scene

  Parse any .tscn file and get full node tree with properties as JSON

  Try:Show me the structure of the main scene fileTry:List all nodes in the level sceneTry:Get the properties of the enemy node in level.tscn
• create_project

  Create a new Godot project from scratch

  Try:Create a new 2D game project named 'MyGame'Try:Initialize a Godot project with 3D settingsTry:Set up a new project at path /projects/NewGame
• manage_export_presets

  Create or modify export preset configuration

  Try:Create a Windows export presetTry:Modify the Android build settingsTry:List all available export presets
• game_http_request

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

  Try:Send a GET request to https://api.example.com/dataTry:Post JSON data to the server endpointTry:Fetch the latest game assets from the CDN
• game_ui_control

  Set focus, anchors, tooltip, mouse filter on UI controls

  Try:Set the main button as focusedTry:Change the anchor preset for the inventory panelTry:Set tooltip text for the help button

Comparable tools

Installation

npm install godot-mcp

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/path/to/godot-mcp/dist/index.js"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

FAQ

Does this require a running Godot instance?

No. Many tools work in headless mode without a running game, though runtime features require an active game instance.

What programming languages does this support?

The server itself is written in JavaScript/TypeScript. It interacts with Godot's GDScript language for game logic.

Compare godot-mcp with