Minecraft MCP Server for Cursor: Setup & Config

What you can do with Minecraft in Cursor

A focused Mineflayer-backed MCP bridge for hands-on assistant interaction with a Minecraft world.

• Inspect inventory and equip items through natural-language requests.
• Read and send in-game messages while interacting with the world.

Before you start: Minecraft in Cursor

• Git
• Node.js 20.10.0 or later
• A running compatible Minecraft game with a reachable world
• An MCP-compatible client

The README opens a single-player world to LAN and configures the bot's host and port to match. Its current support notice names Minecraft 1.21.11, while the setup walkthrough mentions testing Java Edition 1.21.8. Restart the desktop client fully after configuration. No required environment variables are stated.

Minecraft Cursor configuration

1. Choose Cursor configuration scope

   For Minecraft MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Minecraft MCP Server to Cursor

   Use the minecraft-mcp-server entry below in mcpServers. Keep Minecraft MCP Server's documented stdio connection fields and your other Cursor entries.

3. Check Minecraft MCP Server in Cursor

   Minecraft MCP Server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "minecraft-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ],
      "env": {}
    }
  }
}

Minecraft tools available to Cursor

Minecraft's stored tool list documents 18 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

get-position

Find get-position under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

move-to-position

Find move-to-position under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

look-at

Find look-at under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

jump

Find jump under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

move-in-direction

Find move-in-direction under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

fly-to

Find fly-to under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list-inventory

Find list-inventory under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

find-item

Find find-item under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

equip-item

Find equip-item under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

place-block

Find place-block under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Place a block at a selected position.

dig-block

Find dig-block under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Dig the block at a selected position.

get-block-info

Find get-block-info under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect information about a block.

find-blocks

Find find-blocks under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Locate nearby blocks of a requested type.

smelt-item

Find smelt-item under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Process items using a furnace-like block.

find-entity

Find find-entity under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Locate the closest entity matching a requested type.

send-chat

Find send-chat under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Post a message to the game's chat.

read-chat

Find read-chat under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Read recent messages sent by players.

detect-gamemode

Find detect-gamemode under Minecraft in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Determine the current game mode.

Minecraft: full stored tool descriptions

Troubleshooting Minecraft in Cursor

• Cursor must find npx (Node.js/npm) for Minecraft MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
• Minecraft MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a running game and a reachable world.
• Known limitation: The compatibility notice warns that versions newer than 1.21.11 may not work.
• Known limitation: Desktop client startup can take time.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions