Funplay Godot MCP — Claude Code MCP server: features and setup
Connects an AI client to an open Godot project so it can create scenes and scripts, build UI, and test the game in the editor.
claude mcp add --env FUNPLAY_GODOT_MCP_URL=<FUNPLAY_GODOT_MCP_URL> --env GODOT_MCP_URL=<GODOT_MCP_URL> --env FUNPLAY_GODOT_MCP_TOKEN=<FUNPLAY_GODOT_MCP_TOKEN> --env GODOT_MCP_TOKEN=<GODOT_MCP_TOKEN> --transport stdio funplay-godot-mcp -- npx -y funplay-godot-mcpWhat Funplay Godot MCP does
The server gives an AI client access to tools in the running Godot editor. An agent can create scenes, generate scripts, assemble UI, configure animation and camera controls, simulate input, and inspect gameplay in play mode. It supports GDScript projects as well as Godot .NET projects using C#.
Add the addon to your project, enable it in Godot’s plugin settings, then start the server from the Funplay MCP dock. The dock can write client configuration for you; manual setup can use the funplay-godot-mcp package through npx. Requests to the local server need the project auth token. Because authenticated clients can access tools such as execute_code, keep the server running only for trusted local clients and leave safety checks enabled unless you mean to override them.
What it helps with
- build a scene structure from a game description
- generate scripts for a Godot project
- assemble a UI tree and connect its signals
- test gameplay and simulate input
- configure animation and camera controls
Example prompts for the agent
- Create a player scene and movement script for my Godot project.
- Build a HUD with health and ammo indicators, then connect its signals.
- Run the game, test input, and report the open scene state.
How to install Funplay Godot MCP
Platform CLI
claude mcp add --env FUNPLAY_GODOT_MCP_URL=<FUNPLAY_GODOT_MCP_URL> --env GODOT_MCP_URL=<GODOT_MCP_URL> --env FUNPLAY_GODOT_MCP_TOKEN=<FUNPLAY_GODOT_MCP_TOKEN> --env GODOT_MCP_TOKEN=<GODOT_MCP_TOKEN> --transport stdio funplay-godot-mcp -- npx -y funplay-godot-mcpReplace <…> with your own values
Platform CLI
codex mcp add funplay-godot-mcp --env FUNPLAY_GODOT_MCP_URL=<FUNPLAY_GODOT_MCP_URL> --env GODOT_MCP_URL=<GODOT_MCP_URL> --env FUNPLAY_GODOT_MCP_TOKEN=<FUNPLAY_GODOT_MCP_TOKEN> --env GODOT_MCP_TOKEN=<GODOT_MCP_TOKEN> -- npx -y funplay-godot-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"funplay-godot-mcp": {
"command": "npx",
"args": [
"-y",
"funplay-godot-mcp"
],
"env": {
"FUNPLAY_GODOT_MCP_URL": "<FUNPLAY_GODOT_MCP_URL>",
"GODOT_MCP_URL": "<GODOT_MCP_URL>",
"FUNPLAY_GODOT_MCP_TOKEN": "<FUNPLAY_GODOT_MCP_TOKEN>",
"GODOT_MCP_TOKEN": "<GODOT_MCP_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"funplay-godot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"funplay-godot-mcp"
],
"env": {
"FUNPLAY_GODOT_MCP_URL": "<FUNPLAY_GODOT_MCP_URL>",
"GODOT_MCP_URL": "<GODOT_MCP_URL>",
"FUNPLAY_GODOT_MCP_TOKEN": "<FUNPLAY_GODOT_MCP_TOKEN>",
"GODOT_MCP_TOKEN": "<GODOT_MCP_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FUNPLAY_GODOT_MCP_URL=<FUNPLAY_GODOT_MCP_URL> -e GODOT_MCP_URL=<GODOT_MCP_URL> -e FUNPLAY_GODOT_MCP_TOKEN=<FUNPLAY_GODOT_MCP_TOKEN> -e GODOT_MCP_TOKEN=<GODOT_MCP_TOKEN> funplay-godot-mcp npx -y funplay-godot-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Funplay Godot MCP
How do I install Funplay Godot MCP in Claude Code?
Run `claude mcp add funplay-godot-mcp -e FUNPLAY_GODOT_MCP_TOKEN=<FUNPLAY_GODOT_MCP_TOKEN> -e GODOT_MCP_TOKEN=<GODOT_MCP_TOKEN> -- npx -y funplay-godot-mcp`. First add the addon to your Godot project, enable it, and start the server.
What does Funplay Godot MCP do?
It lets an AI client use tools in the open Godot editor to create scenes and scripts, build UI, configure animations, and test gameplay.
Can it work with Godot .NET projects?
Yes. Godot .NET projects can use C#/.NET workflows, while GDScript projects get the corresponding GDScript tools.
