# godot-mcp-native

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 209 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/godot-mcp-native/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/godot-mcp-native

## What it 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.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-mcp-native/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-mcp-native/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-mcp-native/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-mcp-native/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/godot-mcp-native
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-mcp-native/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/godot-mcp-native
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-mcp-native/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill godot-mcp-native -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/godot-mcp-native/SKILL.md

## When to use it
- 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
- Show me the open scene's node tree and locate `Player`.
- Add a `CharacterBody3D` at the scene root and attach `res://scripts/player.gd` to it.
- Check `enemy.gd` for syntax errors, then run the project.

## Similar
- [godot-signals-groups](https://affpapa.org/en/nevibecode/skills/godot-signals-groups.md) — skill · 12300 installs
- [godot-audio](https://affpapa.org/en/nevibecode/skills/godot-audio.md) — skill · 12200 installs
- [godot-ui-theming](https://affpapa.org/en/nevibecode/skills/godot-ui-theming.md) — skill · 718 installs
- [godot-camera-systems](https://affpapa.org/en/nevibecode/skills/godot-camera-systems.md) — skill · 627 installs
- [scenario-godot-architecture](https://affpapa.org/en/nevibecode/skills/scenario-godot-architecture.md) — skill · 452 installs
- [godot-debugging](https://affpapa.org/en/nevibecode/skills/godot-debugging.md) — skill · 385 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
