godot-mcp-native — Claude Code skill for Godot projects
godot-mcp-native is a Claude Code skill that connects an AI assistant to a Godot project over MCP. It can inspect scenes, change scripts and work with the editor.
no license 209 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a claude-codeWhat godot-mcp-native does
Designed for Godot Engine 4.x, this skill lets an assistant work with project elements through an MCP server. It can inspect a scene tree, add or move nodes, change node properties, create scenes and handle GDScript. You can also ask it to check a script for syntax errors or attach that script to a node.
The Godot MCP Native plugin must be enabled in the project, and the assistant needs a connection to its MCP server. The server uses HTTP and listens on port 9080 by default, so the assistant's connection settings must match. The skill covers project, scene, script and editor operations.
Install the skill for the IDE or CLI you use. That does not enable the Godot plugin; activate the plugin in the project settings separately.
What it helps with
- inspect the node tree of the open scene
- add or move a node in a Godot scene
- change a node property by its path
- read a GDScript file and check its syntax
- create a scene and run the project
Example prompts for the agent
- Show me the open scene's node tree and locate
Player. - Add a
CharacterBody3Dat the scene root and attachres://scripts/player.gdto it. - Check
enemy.gdfor syntax errors, then run the project.
How to install godot-mcp-native
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a claude-code2Manually: put the files in place
~/.claude/skills/godot-mcp-native/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-mcp-native/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a codex2Manually: put the files in place
.agents/skills/godot-mcp-native/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a cursor2Manually: put the files in place
.cursor/skills/godot-mcp-native/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/godot-mcp-native2Manually: put the files in place
.github/skills/godot-mcp-native/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/godot-mcp-nativeManually: put the files in place
.devin/skills/godot-mcp-native/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-mcp-native
How do I install godot-mcp-native in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a claude-code. The skill file is at ~/.claude/skills/godot-mcp-native/SKILL.md.
What does godot-mcp-native do?
It gives an assistant MCP access to Godot project operations, including editing nodes, scenes and GDScript. It can also interact with the editor and run the project.
What must be set up in Godot for godot-mcp-native to work?
Enable the Godot MCP Native plugin in the project and connect the assistant to its HTTP server. The default server port is 9080.