Godot MCP Install Guide: Install via addons and Connect an AI IDE

What This Guide Covers

Follow these five steps to connect open-source Godot MCP to a local Godot project so Cursor (or another MCP-capable AI IDE) can operate, preview, and debug the editor—not just edit scripts on disk.

When you finish, you should be able to:

• Place the plugin in the project addons folder and enable it
• Start the local Godot MCP Server (default port 3000)
• Use one-click configure to register the server in Cursor and confirm the connection

Open-source repository: DaxianLee/godot-mcp

Prerequisites

Item	Notes
Godot	Installed, with a project you can open
Plugin package	godot-mcp release or source ZIP from GitHub
AI IDE	Cursor recommended; other MCP clients also work
Local network	The MCP bridge usually runs on 127.0.0.1—do not expose the port publicly

Step 1: Download Godot MCP

Download open-source Godot MCP from GitHub:

Repository: https://github.com/DaxianLee/godot-mcp

Suggested flow:

1. Open the repo and use Code → Download ZIP, or grab the latest package from Releases
2. Save the archive locally and prepare to extract it
3. Confirm the package looks like a Godot plugin (an addons-related folder, or a plugin folder you can drop into addons)

Step 2: Add Godot MCP to Your Project

1. Extract the archive on your machine
2. Move the extracted plugin folder into the addons directory at the Godot project root
   • If addons does not exist yet, create it first
3. Open (or reload) the project in Godot and confirm the plugin files appear in the FileSystem dock

Example project layout after import:

Step 3: Enable the Godot MCP Plugin

1. Open Project → Project Settings (or the equivalent for your Godot version)
2. Go to the Plugins tab
3. Find Godot MCP Server (name may vary slightly in the UI)
4. Enable it

After enabling, a Godot MCP entry should appear in a side or dock panel so you can set the port and start the server next.

Step 4: Start Godot MCP Server

1. In the Godot editor right-hand panel, open the GodotMCP dock
2. Review and adjust as needed:
   • Port: default 3000
   • Language: pick what matches your UI preference
   • Startup: you can enable auto-start so the server comes up when you open the project
3. Click Start
4. When the panel shows Running (or the localized equivalent), Godot MCP Server is up

You now have a local MCP bridge. Next, hand it to your AI IDE.

Step 5: One-Click AI IDE Setup (Cursor Example)

1. In the GodotMCP panel, open Tools
   • Review the tools exposed by the server
   • Enable only the capabilities you want the AI to use
2. Open Configure
   • Choose your IDE (for example Cursor)
   • Click One-click configure
   • Wait for a configuration successful message
3. Open Cursor
   • In the MCP / tools list you should see godot-mcp connected automatically
   • If it does not appear, click Reload (or the equivalent MCP reload action) in Cursor and check again

Configuration and connection:

Quick verification after connecting

In Cursor, start with a read-only check, for example:

List the root nodes of the active Godot scene.

If the reply matches the editor Hierarchy, the bridge works. Then try a small write (create a temporary node and delete it) to confirm permissions and tool selection.

FAQ

I copied files into addons, but Godot MCP Server is missing from the plugin list?
Make sure the folder sits at addons/<plugin-name>/ and is not nested one extra unzip level. Reload the project or restart Godot.

I clicked Start but never see Running?
Confirm port 3000 (or your custom port) is free, then retry. Check that nothing is blocking localhost.

Cursor does not show godot-mcp?
In Godot, confirm the server is still Running, run one-click configure again, then reload MCP in Cursor. If it still fails, check that Cursor’s MCP config includes the local bridge address.

Auto-start is on, but I still have to start manually?
Some builds need one successful manual start first. Confirm the checkbox is saved, then reopen the same project and verify.

Next Steps

• Use natural language for a scene query or a small edit to learn the tool boundaries
• Commit before large changes; keep the bridge on localhost only
• For design-to-engine UI handoff, pair with VberAI AI Studio, then iterate in-editor with MCP

For more Godot + MCP background, see How we built a real-time MCP server for Godot.