home / mcp / godot mcp server

Godot MCP Server

MCP server enabling two-way communication between AI assistants and Godot for scripts, scenes, nodes, and project resources.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "ee0pdt-godot-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_PROJECT/server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Godot MCP provides a direct bridge between the Godot Engine and AI assistants using the Model Context Protocol. It lets you access and edit your Godot project from AI within a workflow that supports code assistance, scene manipulation, and project management, all from natural language prompts.

How to use

After you set up the MCP server, you can interact with your Godot project from an AI assistant using natural language prompts. You can inspect the current script or scene, ask the AI to modify nodes, update GDScript, or adjust project settings. The AI can also execute editor actions or run the project to test changes. Use prompts that reference the currently opened resources, for example asking to read the current script, display the scene tree, or add a new node and set its properties. Create tasks such as placing objects, wiring up signals, or refactoring code, and have the assistant apply the changes back to your Godot editor.

Example prompts

Read the currently open script and suggest optimizations for the performance-critical section.

Add a cube in the middle of the scene and orient a camera to look at it.

Read the current scene structure and propose a hierarchy improvement for a boss encounter.

Available tools

get-scene-tree

Returns the full scene tree structure for the currently loaded project, enabling you to understand scene composition and relationships.

get-node-properties

Fetches properties for a specific node in the active scene, allowing you to inspect and edit node configurations.

create-node

Creates a new node within the active scene with specified type and parent.

delete-node

Deletes a node from the active scene based on its path or identifier.

modify-node

Updates properties of a specified node to apply changes in the editor.

list-project-scripts

Lists all GDScript files in the project for quick discovery and editing.

read-script

Reads the contents of a specific script for review or modification.

modify-script

Updates the content of a script and applies changes to the project.

create-script

Creates a new GDScript file in the project with initial content.

analyze-script

Provides analysis and optimization suggestions for a script's structure and performance.

list-project-scenes

Lists all scenes in the project to help you navigate and organize content.

read-scene

Reads the structure of a scene for inspection and modification.

create-scene

Creates a new scene with a given structure or template.

save-scene

Saves the current scene state to disk.

get-project-settings

Fetches project settings and configuration details.

list-project-resources

Lists project resources such as scripts, scenes, and assets.

get-editor-state

Retrieves the current editor state, including open files and active panels.

run-project

Runs the Godot project to test changes in the running environment.

stop-project

Stops a running project and resets the editor state.

Godot MCP Server - ee0pdt/godot-mcp