Skip to content
Back to search

godot-ai

Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hi-godot/godot-ai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hi-godot/godot-ai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hi-godot--godot-ai/badge.svg)](/listings/hi-godot--godot-ai)

HTML

<a href="/listings/hi-godot--godot-ai"><img src="/api/listings/hi-godot--godot-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements

- Godot **4.7+** within the 4.x line for Godot AI v4 - [uv](https://docs.astral.sh/uv/getting-started/installation/), which provides `uvx` for the Python server - An MCP client

**Script languages.** GDScript is fully supported: scripts written through the tools are parse-validated, hot-reloaded, attached, and outlined. C# is **text-only**: `script_create` / `script_patch` write `.cs` files and `script_manage(op="find_symbols")` outlines them, but Godot AI does not build .NET or report C# compiler errors. Build in the editor and inspect its Build panel, or run `dotnet build` and inspect the terminal output. Attaching a `.cs` needs a .NET-enabled editor build. Details: [C# support](docs/TOOLS.md#c-support).

1. Install or update

**New project:** choose a published version from [GitHub Releases](https://github.com/hi-godot/godot-ai/releases) and follow its verification and installation instructions. The add-on belongs at `your-project/addons/godot_ai/`, with `plugin.cfg` inside that directory. Use the release's requirements and package—not a source snapshot copied over an existing installation.

**Existing installation:** click **Update** in the Godot AI dock when an update is offered. The final signed v3 release supports a one-click migration to v4; Godot restarts once and owned, supported client entries are migrated automatically. Do not extract a new add-on over the old tree. See the [v3 → v4 migration guide](docs/v4-migration.md) for compatibility and recovery.

For development from source, use the [contributor setup](docs/CONTRIBUTING.md).

2. Enable the plugin

In Godot: **Project → Project Settings → Plugins → Godot AI**.

The plugin starts the MCP server and shows connection status in the **Godot AI** dock. If it is missing from the plugin list, check that the file is at `addons/godot_ai/plugin.cfg`, not `addons/plugin.cfg`.

3. Connect your MCP client

In the dock, press **Configure** next to your client, or **Configure all** for every detected client. If the client does not notice the new configuration, restart that client.

Supported clients include **Claude Code**, **Claude Desktop**, **Codex**, **Antigravity**, **Hermes Agent**, **DeepSeek Harness**, **Cursor**, **VS Code**, and **Oh My Pi** (manual configuration). The dock lists all supported clients and provides a **Run this manually** fallback where needed.

Use the dock-generated command: it includes the matching version, ports, resolver options, and excluded tool domains. V4 uses `godot-ai attach` over stdio; a bare `http://127.0.0.1:8000/mcp` entry cannot authenticate or follow capability rotation. Updates repin owned client entries automatically; reconfigure after changing ports, telemetry preferences, or tool domains.

**Client exceptions:** Pi Coding Agent needs an MCP extension that reads `~/.pi/agent/mcp.json`. Cherry Studio is not supported in v4; remove stale v3 entries in Cherry Studio itself.

<details> <summary><strong>Per-project configuration</strong></summary>

CLI-configured clients default to global `user` scope. Set **Editor Settings → Plugins → `godot_ai/mcp_client_scope`** to `project` (or `local`, where supported), then press **Configure** again.

**Configure** removes existing `godot-ai` entries from every scope before writing the selected one. This can modify a checked-in `.mcp.json`, but does not touch other server entries. **Remove** affects only the selected scope.

Launch Godot from the project directory so the client CLI writes configuration in the right place. Claude Code also requires one-time approval from `claude` run inside that project.

</details>

4. Try it

- *"Show me the current scene hierarchy."* - *"Create a Camera3D named MainCamera under /Main."* - *"Search the project for PackedScene files in ui/."* - *"Run the scene test suite."* - *"Build a voxel block-world game with a player, blocks to place and destroy, and save slots."*

<p align="center">

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="docs/hero.png" alt="Godot AI — The wait is over" width="700">
  3. </p>
  4. # Godot AI
  5. [![CI](https://github.com/hi-godot/godot-ai/actions/workflows/ci.yml/badge.svg)](https://github.com/hi-godot/godot-ai/actions/workflows/ci.yml)
  6. [![codecov](https://codecov.io/gh/hi-godot/godot-ai/graph/badge.svg)](https://codecov.io/gh/hi-godot/godot-ai)
  7. [![Discord](https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/FDZ5fr2QkP)
  8. **Godot AI connects Claude Code, Codex, Cursor, and other
  9. [MCP](https://modelcontextprotocol.io/introduction) clients to a live Godot
  10. editor.** Its [46 tools and 120+ operations](docs/TOOLS.md) build scenes, edit
  11. nodes and scripts, wire signals, and configure UI, materials, animation,
  12. particles, cameras, and environments.
  13. **21,000+ monthly active installs · 30M+ tool calls in the last three months · 3,200+ GitHub stars**
  14. <br><sub>Install and tool-call counts come from anonymous telemetry and exclude opted-out installs: the 30 days, and July 27 onward, to October 25, 2026.</sub>
  15. <p align="center">
  16. <img src="docs/images/huddemo.gif" alt="Cyberpunk HUD demo" width="800"><br>
  17. <em>Built in ~2 hours with Godot AI, without hand-written code or image generation — <a href="https://github.com/hi-godot/cyberpunk-hud-demo">source</a></em>
  18. </p>
  19. ## Quick start
  20. You need **Godot 4.7+**, [uv](https://docs.astral.sh/uv/getting-started/installation/)
  21. (it runs the Python server), and an MCP client.
  22. 1. **Install uv** (once):
  23. - macOS/Linux:
  24. ```sh
  25. curl -LsSf https://astral.sh/uv/install.sh | sh
  26. ```
  27. - Windows (PowerShell):
  28. ```powershell
  29. irm https://astral.sh/uv/install.ps1 | iex
  30. ```
  31. 2. **Install the add-on** from the Asset Store (Godot's **AssetLib** tab), or
  32. from a [GitHub release](https://github.com/hi-godot/godot-ai/releases) into
  33. `your-project/addons/godot_ai/`.
  34. 3. **Enable it:** **Project → Project Settings → Plugins → Godot AI**.
  35. 4. **Connect your client:** in the **Godot AI** dock, press **Configure** next
  36. to your client, or **Configure all**. Restart the client if it doesn't
  37. notice the change.
  38. <p align="center">
  39. <img src="docs/images/dock-v4.png" alt="Godot AI dock showing a connected server and configured clients" width="396">
  40. </p>
  41. **Already installed?** Click **Update** in the dock. Never extract a new
  42. version over an existing `addons/godot_ai/`. From v3, the same button migrates
  43. you to v4 ([migration guide](docs/v4-migration.md)).
  44. <details>
  45. <summary><strong>Supported clients and exceptions</strong></summary>
  46. The dock configures 26 clients, including Claude Code, Claude Desktop, Codex,
  47. Cursor, VS Code, Antigravity, Gemini CLI, and Hermes Agent, and shows a
  48. **Run this manually** command for the rest.
  49. - Use the dock-generated command: it pins the matching version, ports, and
  50. tool domains. v4 clients connect through `godot-ai attach` over stdio; a bare
  51. `http://127.0.0.1:8000/mcp` entry cannot authenticate.
  52. - Updates repin owned client entries automatically. The default scope is
  53. global, so this also redirects other projects still on an older version;
  54. update them too. Reconfigure after changing ports, telemetry preferences, or
  55. tool domains.
  56. - Pi Coding Agent needs an MCP extension that reads `~/.pi/agent/mcp.json`.
  57. Cherry Studio is not supported in v4; remove stale v3 entries in Cherry
  58. Studio itself.
  59. Details: [client configuration](docs/client-configuration.md).
  60. </details>
  61. <details>
  62. <summary><strong>Per-project configuration</strong></summary>
  63. CLI-configured clients default to global `user` scope. Set **Editor Settings →
  64. Plugins → `godot_ai/mcp_client_scope`** to `project` (or `local`, where supported),
  65. then press **Configure** again.
  66. **Configure** removes existing `godot-ai` entries from every scope before
  67. writing the selected one. This can modify a checked-in `.mcp.json`, but does not
  68. touch other server entries. **Remove** affects only the selected scope.
  69. Launch Godot from the project directory so the client CLI writes configuration
  70. in the right place. Claude Code also requires one-time approval from `claude`
  71. run inside that project.
  72. </details>
  73. <details>
  74. <summary><strong>GDScript and C#</strong></summary>
  75. GDScript is fully supported: scripts are parse-validated, hot-reloaded,
  76. attached, and outlined. C# is **text-only**: `script_create` / `script_patch`
  77. write `.cs` files and `script_manage(op="find_symbols")` outlines them, but
  78. Godot AI does not build .NET or report compiler errors. Attaching a `.cs` needs
  79. a .NET-enabled editor build. [C# support](docs/TOOLS.md#c-support).
  80. </details>
  81. ### Try it
  82. - *"Show me the current scene hierarchy."*
  83. - *"Create a Camera3D named MainCamera under /Main."*
  84. - *"Run the scene test suite."*
  85. - *"Build a voxel block-world game with a player, blocks to place and destroy, and save slots."*
  86. <p align="center">
  87. <img src="docs/images/blockarena.gif" alt="Block-world game built with Godot AI" width="640"><br>
  88. <em>A block-world game with a save system, built from a handful of prompts — <a href="https://github.com/dsarno/save-system-godot-claude">source</a></em>
  89. </p>
  90. ## Security
  91. Godot AI has prioritized security from the start. Today that includes:
  92. - **Signed releases.** The in-editor updater verifies the signature and every
  93. file before it installs anything.
  94. - **Authenticated local connections.** The server and the editor accept only
  95. connections that present rotating credentials, and the editor connection is
  96. loopback-only.
  97. - **Project confinement.** Writes stay inside your project, and
  98. `project.godot`, `override.cfg`, and `.godot/` are off-limits.
  99. - **A guarded release pipeline.** Pinned dependencies, qualification on Linux,
  100. macOS, and Windows, and a human approval before anything is published.
  101. - **Open disclosure.** Vulnerabilities are fixed and published as
  102. [security advisories](https://github.com/hi-godot/godot-ai/security/advisories).
  103. **Update promptly.** 4.3.1, for example, removes the emSign root certificates
  104. compromised in October 2026.
  105. That said, attacks on open-source supply chains are increasing, and more critical
  106. vulnerabilities will appear in Godot AI, its dependencies, and the tools
  107. around it. Following advisories and the wider security landscape is your
  108. responsibility. Godot AI is MIT-licensed open source, provided as is; you use
  109. it at your own risk.
  110. <details>
  111. <summary><strong>How it works</strong></summary>
  112. ```text
  113. MCP client
  114. → godot-ai attach (stdio)
  115. → Python server (authenticated HTTP, port 8000)
  116. → Godot editor plugin (authenticated WebSocket, port 9500)
  117. ```
  118. Both local hops use independent rotating capabilities; neither falls back to
  119. unauthenticated access, and the editor WebSocket stays loopback-only. These
  120. controls do not protect against a compromised same-user process, and Windows
  121. does not claim isolation from other local accounts. See the
  122. [security model](docs/plugin-architecture.md#security-model),
  123. [package trust boundaries](docs/packaging-distribution.md), and
  124. [agents on another machine or in a container](docs/client-configuration.md#agents-on-another-machine-or-in-a-container).
  125. </details>
  126. ## Privacy
  127. Anonymous telemetry records an installation UUID, event, outcome, duration,
  128. platform, and version, never code, scene contents, or project or file names.
  129. Opt out with `GODOT_AI_DISABLE_TELEMETRY=true` or `DISABLE_TELEMETRY=true`, or
  130. in the editor. [Details](docs/TELEMETRY.md).
  131. ## Docs and help
  132. - [Tools, operations, and resources](docs/TOOLS.md) ·
  133. [Write and run tests for your game](docs/testing.md) ·
  134. [Community addons and custom tools](docs/community-addons.md)
  135. - [Upgrading from v3](docs/v4-migration.md) ·
  136. [Linux troubleshooting](docs/troubleshooting-linux.md) (Bazzite, Steam, Flatpak) ·
  137. [Changelog](CHANGELOG.md)
  138. - [Contributing](docs/CONTRIBUTING.md) ·
  139. [Discord](https://discord.gg/FDZ5fr2QkP) for questions and showcases ·
  140. [GitHub Issues](https://github.com/hi-godot/godot-ai/issues) for bugs
  141. ## Star History
  142. <!-- Generated by .github/workflows/star-history.yml on the star-history branch. -->
  143. <a href="https://github.com/hi-godot/godot-ai/stargazers">
  144. <img src="https://raw.githubusercontent.com/hi-godot/godot-ai/star-history/star-history.svg" alt="Star History Chart" width="700">
  145. </a>
  146. **License:** [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.