godot-mcp-native

Control Godot Engine projects via MCP to create nodes, edit scripts, and debug games.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill godot-mcp-native-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: godot-mcp-native
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/godot-mcp-native
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill godot-mcp-native-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mcp-remote.

What problem does it solve? Manually building Godot scenes, writing GDScript, and debugging runtime behavior requires constant context switching between the editor and documentation. This Skill lets AI assistants directly read and modify Godot 4.x projects through natural language, exposing 154 tools for node manipulation, script editing, scene management, and runtime debugging. ## Core Features & Use Cases - Node & Scene Operations: Create, move, rename, duplicate, and delete nodes, inspect the scene tree, and build or open scenes programmatically. - Script Management: Create, read, modify, validate, analyze, and attach GDScript files, plus execute expressions in the editor context. - Runtime Debugging: Install a runtime probe to inspect live scene trees, modify properties in the running game, set breakpoints, and step through the call stack. - Use Case: Ask your AI assistant to create a CharacterBody3D player with a mesh, collision shape, and movement script, then run the project and inspect the player's live position during gameplay. ## Quick Start Install the Godot MCP Native plugin from the Asset Library, enable it in Project Settings, connect your MCP client to http://localhost:9080/mcp, then ask the AI to show the current scene tree.

Frequently Asked Questions about godot-mcp-native

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude Desktop to a Godot project via MCP?▼

Install the Godot MCP Native plugin in your project, enable it, then install mcp-remote via npm and add a godot-mcp server entry pointing to http://localhost:9080/mcp in your claude_desktop_config.json file.

How to create and script a Godot node with an AI assistant?▼

Use the create-node tool with a node name, Godot class type, and parent path, then use create-script to write a GDScript file and attach-script to bind it to the node. All steps run through natural language MCP commands.

Does Godot MCP Native support Godot 3.x projects?▼

No, the plugin is built for Godot Engine 4.x and implemented natively in GDScript without external dependencies. Godot 3.x projects are not supported by this plugin.

Can I debug a running Godot game through MCP?▼

Yes, install the runtime probe before running the project, then use get-runtime-scene-tree, inspect-runtime-node, and update-runtime-node-property to view and modify live state. Breakpoints and stack frame inspection are also available.

Why is the Godot MCP server not responding on port 9080?▼

Verify the Godot project is open with the plugin enabled and check the Output panel for the startup message. Ensure the port is not blocked by a firewall and test connectivity with curl http://localhost:9080/mcp.

How do I fix node path not found errors in Godot MCP?▼

Run get-scene-tree to verify exact node paths first. Paths are relative to the scene root unless prefixed with /root/, so a root child is referenced as "Player" rather than "/Player".