← Back to blog

VberAI Godot MCP: Install Plugin & Enable in Godot 4

VberAI Godot MCP install: download plugin, add to addons, enable in Godot 4, start server, verify godot-mcp in Cursor or Claude Code.

Published · Updated
  • godot
  • mcp
  • cursor
  • tutorial
  • godot-mcp
  • ai
  • vberai

Install the VberAI Godot MCP Plugin (Godot 4)

If you searched vberai godot mcp, install godot mcp plugin, or turning on mcp in godot 4, this is the official install path: download the open-source Godot MCP plugin, drop it in addons, enable it in Project Settings, start the local server, and confirm godot-mcp in Cursor (or another MCP-capable AI IDE).

These five steps cover download → addons → enable plugin → start Server → verify in Cursor.

When you finish, you should be able to:

  • Place the plugin in the project addons folder and enable it in Project Settings
  • Start the local Godot MCP Server (default port 3000)
  • Use one-click configure to register the server in Cursor and confirm godot-mcp is connected (and can list scene nodes)

Enable checklist (scan first)

  1. Plugin folder is at addons/<plugin-name>/ (no extra nest level)
  2. Project Settings → Plugins: Godot MCP Server is enabled
  3. GodotMCP panel shows Running
  4. Cursor MCP list shows godot-mcp (Reload if needed)
  5. A read-only prompt can list root nodes of the active scene

Open-source repository: DaxianLee/godot-mcp · Product page: Godot MCP

Prerequisites

ItemNotes
GodotInstalled, with a project you can open
Plugin packagegodot-mcp release or source ZIP from GitHub
AI IDECursor recommended; other MCP clients also work
Local networkThe 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:

Place the Godot MCP plugin folder under the project addons directory

Step 3: Enable the Godot MCP Plugin in Project Settings

  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.

Enable Godot MCP Server in Project Settings → Plugins

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.

Configure the port in the GodotMCP panel and start until Running is shown

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:

One-click configure Cursor from GodotMCP and confirm godot-mcp is connected

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

How do I install the Godot MCP plugin?
Download from DaxianLee/godot-mcp, place the plugin folder under your project addons/ directory, enable Godot MCP Server in Project Settings → Plugins, then start the server from the GodotMCP panel. Full walkthrough: Steps 1–5 above.

How do I turn on MCP in Godot 4?
After the plugin is in addons/, open Project → Project Settings → Plugins, enable Godot MCP Server, open the GodotMCP dock, set port (default 3000), and click Start until the panel shows Running.

What is vberai godot mcp?
VberAI Godot MCP is the product name for the open-source Godot editor bridge on vberai.com/game-engines/godot. It lets Cursor, Claude Code, and similar clients operate the open Godot editor via MCP—not only edit scripts on disk.

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 Studio, then iterate in-editor with MCP

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

More guides you might like