Godot MCP

What is Godot MCP?

Godot MCP is a plugin for the Godot Engine that acts as a bridge between your Godot projects and AI assistants using the standardized Model Context Protocol. It allows AI tools to access, analyze, and modify scripts, scenes, nodes, and project settings directly, enabling new AI-powered workflows for development, debugging, and creative collaboration.

How to Configure Godot MCP

Clone the godot-mcp repository and navigate to its directory.
Build and set up the MCP server by running npm install and npm run build in the /server directory.
Edit your Claude Desktop configuration file (e.g., claude_desktop_config.json) to add an MCP server entry pointing to your built server's entry file.
Make sure to replace PATH_TO_YOUR_PROJECT with the absolute path to your cloned repository.
Restart Claude Desktop to apply the changes.
In Godot, open the provided example project or add the addons/godot_mcp folder to your own project's addons directory.
Enable the plugin from Project > Project Settings > Plugins in the Godot Editor.

How to Use Godot MCP

With the MCP server running and the plugin enabled, interact with your Godot project from the AI assistant interface (e.g., Claude Desktop) using structured or natural language prompts. Preface commands with @mcp godot-mcp to send requests through the MCP server. You can request code suggestions, scene changes, AI-generated content, and run project or resource commands directly.

Example Prompts

@mcp godot-mcp read godot://script/current
"I need help optimizing my player movement code. Can you suggest improvements?"
@mcp godot-mcp run get-scene-tree
"Add a cube in the middle of the scene and then make a camera that is looking at the cube."
@mcp godot-mcp read godot://scene/current
"Create an enemy AI that patrols between waypoints and attacks the player when in range."

Key Features

Seamless two-way communication between Godot and AI assistants
Access and modify project resources, scripts, scenes, and nodes programmatically
Extensive command set for node management, script editing, scene and project control
Easily extensible with additional MCP tool endpoints
Secure, local or remote setup with support for integration via Claude Desktop
Natural language AI-driven assistance for coding, debugging, and scene creation

Use Cases

AI-driven code review, generation, and refactoring for GDScript files
Automated scene creation, node management, and procedural environment generation
Project-wide analysis for performance optimization or error detection
Implementing gameplay logic, AI behaviors, and UI elements via AI suggestions
Batch editing or creation of resources and settings through AI guidance
Accelerating prototyping, learning, or collaborative development in Godot projects

FAQ

Q: The plugin isn’t working or doesn’t appear in Godot. What should I do?
A: Ensure you have enabled the "Godot MCP" plugin in Project > Project Settings > Plugins. If you recently copied the addon or made config changes, try reloading the project and check for error messages in the Godot console.

Q: Claude Desktop can’t connect to the MCP server. What’s wrong?
A: Verify that the server runs successfully (no errors on startup) and that your Claude Desktop config has the correct absolute path. Make sure MCP_TRANSPORT is set to stdio. Restart Claude Desktop after updating the config.

Q: Can I use Godot MCP with my existing projects, or only the included example?
A: Yes, you can use it with any Godot project. Just copy the addons/godot_mcp folder into your project's addons directory and enable the plugin from the settings.

Q: What if I want to extend Godot MCP or add custom commands?
A: The plugin and server are open-source and designed for extensibility. You can implement new endpoints in the MCP server or extend the Godot addon to expose additional functionality.

Q: Is my project’s data secure when using Godot MCP?
A: Yes, by default the MCP server runs on your local machine and only accesses files and data you permit. Review server configurations and always keep best practices for data security in mind.

Tool Name	Description
get-scene-tree	Retrieves a structured representation of the current scene tree, including all nodes and their relationships, allowing the AI to analyze or modify the scene’s structure.
create-node	Inserts a new node of a specified type into the current scene at a given location or as a child of another node.
modify-script	Updates the contents of a specified GDScript file, supporting code suggestions, refactoring, or automated fixes as proposed by the AI.
list-project-scripts	Returns a list of all GDScript files in the project for navigation, bulk operations, or AI analysis.
get-project-settings	Provides access to the project’s configuration, metadata, and relevant resource paths so AI can query or suggest changes.

Godot MCP is a powerful integration plugin that connects the Godot Engine with AI assistants such as Claude via the Model Context Protocol, enabling AI-driven project assistance, code modification, and scene manipulation from within your development environment.