Godot MCP (Model Context Protocol)

Features

• Full Godot Project Access: AI assistants can access and modify scripts, scenes, nodes, and project resources

• Two-way Communication: Send project data to AI and apply suggested changes directly in the editor

• Command Categories:

Quick Setup

1. Clone the Repository

2. Set Up the MCP Server

3. Set Up Claude Desktop

1. Edit or create the Claude Desktop config file:

2. Add the following configuration (or use the included claude_desktop_config.json as a reference):

3. Restart Claude Desktop

4. Open the Example Project in Godot

1. Open Godot Engine

2. Select "Import" and navigate to the cloned repository

3. Open the project.godot file

4. The MCP plugin is already enabled in this example project

Using MCP with Claude

Example Prompts

Natural Language Tasks Claude Can Perform

• "Create a main menu with play, options, and quit buttons"

• "Add collision detection to the player character"

• "Implement a day/night cycle system"

• "Refactor this code to use signals instead of direct references"

• "Debug why my player character falls through the floor sometimes"

Available Resources and Commands

Resource Endpoints:

• godot://script/current - The currently open script

• godot://scene/current - The currently open scene

• godot://project/info - Project metadata and settings

Command Categories:

Node Commands

• get-scene-tree - Returns the scene tree structure

• get-node-properties - Gets properties of a specific node

• create-node - Creates a new node

• delete-node - Deletes a node

• modify-node - Updates node properties

Script Commands

• list-project-scripts - Lists all scripts in the project

• read-script - Reads a specific script

• modify-script - Updates script content

• create-script - Creates a new script

• analyze-script - Provides analysis of a script

Scene Commands

• list-project-scenes - Lists all scenes in the project

• read-scene - Reads scene structure

• create-scene - Creates a new scene

• save-scene - Saves current scene

Project Commands

• get-project-settings - Gets project settings

• list-project-resources - Lists project resources

Editor Commands

• get-editor-state - Gets current editor state

• run-project - Runs the project

• stop-project - Stops the running project

Troubleshooting

Connection Issues

• Ensure the plugin is enabled in Godot's Project Settings

• Check the Godot console for any error messages

• Verify the server is running when Claude Desktop launches it

Plugin Not Working

• Reload Godot project after any configuration changes

• Check for error messages in the Godot console

• Make sure all paths in your Claude Desktop config are absolute and correct

Adding the Plugin to Your Own Godot Project

1. Copy the addons/godot_mcp folder to your Godot project's addons directory

2. Open your project in Godot

3. Go to Project > Project Settings > Plugins

4. Enable the "Godot MCP" plugin

Contributing

Documentation

• Getting Started

• Installation Guide

• Command Reference

• Architecture

License

Godot MCP (Model Context Protocol)

Features

• Full Godot Project Access: AI assistants can access and modify scripts, scenes, nodes, and project resources

• Two-way Communication: Send project data to AI and apply suggested changes directly in the editor

• Command Categories:

Quick Setup

1. Clone the Repository

2. Set Up the MCP Server

3. Set Up Claude Desktop

1. Edit or create the Claude Desktop config file:

2. Add the following configuration (or use the included claude_desktop_config.json as a reference):

3. Restart Claude Desktop

4. Open the Example Project in Godot

1. Open Godot Engine

2. Select "Import" and navigate to the cloned repository

3. Open the project.godot file

4. The MCP plugin is already enabled in this example project

Using MCP with Claude

Example Prompts

Natural Language Tasks Claude Can Perform

• "Create a main menu with play, options, and quit buttons"

• "Add collision detection to the player character"

• "Implement a day/night cycle system"

• "Refactor this code to use signals instead of direct references"

• "Debug why my player character falls through the floor sometimes"

Available Resources and Commands

Resource Endpoints:

• godot://script/current - The currently open script

• godot://scene/current - The currently open scene

• godot://project/info - Project metadata and settings

Command Categories:

Node Commands

• get-scene-tree - Returns the scene tree structure

• get-node-properties - Gets properties of a specific node

• create-node - Creates a new node

• delete-node - Deletes a node

• modify-node - Updates node properties

Script Commands

• list-project-scripts - Lists all scripts in the project

• read-script - Reads a specific script

• modify-script - Updates script content

• create-script - Creates a new script

• analyze-script - Provides analysis of a script

Scene Commands

• list-project-scenes - Lists all scenes in the project

• read-scene - Reads scene structure

• create-scene - Creates a new scene

• save-scene - Saves current scene

Project Commands

• get-project-settings - Gets project settings

• list-project-resources - Lists project resources

Editor Commands

• get-editor-state - Gets current editor state

• run-project - Runs the project

• stop-project - Stops the running project

Troubleshooting

Connection Issues

• Ensure the plugin is enabled in Godot's Project Settings

• Check the Godot console for any error messages

• Verify the server is running when Claude Desktop launches it

Plugin Not Working

• Reload Godot project after any configuration changes

• Check for error messages in the Godot console

• Make sure all paths in your Claude Desktop config are absolute and correct

Adding the Plugin to Your Own Godot Project

1. Copy the addons/godot_mcp folder to your Godot project's addons directory

2. Open your project in Godot

3. Go to Project > Project Settings > Plugins

4. Enable the "Godot MCP" plugin

Contributing

Documentation

• Getting Started

• Installation Guide

• Command Reference

• Architecture

License