Skip to content
MCP server

Minecraft MCP

Let an AI agent play in your own Minecraft client, with a stop command for you

Runs locallyStatus and history
Install
Platforms
CLI, Windows, macOS
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About Minecraft MCP

Minecraft MCP is an MCP server for games and play. It runs locally on your machine and is started by your AI client.

The agent drives your character through JsMacros scripts: it writes a script, runs it, reads the output, takes a screenshot and reports in chat. You watch from your own point of view and type /mcp stop to disable the agent, cancel scripts and release held keys.

It has three parts: a Fabric mod that runs commands in the game, a skill that teaches the agent the available APIs, and the MCP server. The mod shows a token and a port (28473 by default) with F8, and the server needs that token. Requirements are Fabric only for now, Java 25 or later, JsMacros Reloaded and Node.js 22 or later. Baritone is optional but strongly recommended; without it the agent must script its own pathfinding.

The README's gallery says a Codex agent went from an empty inventory to defeating the Ender Dragon in about 8 hours 25 minutes. It warns that the token gives control of your game and recommends running agent, server and game on one computer, with remote access off by default.

Install

Run in a terminal

claude mcp add minecraft-mcp --env MINECRAFT_MCP_TOKEN='<MINECRAFT_MCP_TOKEN>' -- npx -y @makkch/minecraft-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "minecraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "minecraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "minecraft-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "minecraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "minecraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MINECRAFT_MCP_TOKENToken shown in the Minecraft MCP mod settings (F8).Required
  • MINECRAFT_MCP_PORTPort shown in the Minecraft MCP mod settings.
  • MINECRAFT_MCP_URLOptional HTTP(S) game bridge base URL, including a proxy path prefix. Overrides MINECRAFT_MCP_PORT. The MCP process stays on the agent computer.

What it does

Scripted control
Controls the player through JsMacros scripts the agent writes and runs.
Screenshots and chat
Reads output, captures screenshots and reports back in chat.
Stop command
/mcp stop gives you the controls back at once.
Token-protected bridge
The mod requires a token shown in its F8 settings.
Optional pathfinding
Baritone support helps with navigation and gathering.
Agent skill
A skill documents the APIs and how to write scripts.

Good for

  • Have an agent gather resources while you watch
  • Build structures and export schematics
  • Test an agent's long-horizon planning in a game
  • Inspect what your client currently sees

Minecraft MCP FAQ

How do I take control back?

Type /mcp stop in game.

Which Minecraft setups work?

Fabric only, for Java Edition 26.1 to 26.3, with matching JsMacros Reloaded.

Is Baritone required?

No, but it is strongly recommended for pathfinding.

Which agents work?

Codex, Claude Code, Claude Desktop, Cursor or any client with stdio MCP support.

How do I add Minecraft MCP to Claude Code?

Run this command in your terminal: claude mcp add minecraft-mcp --env MINECRAFT_MCP_TOKEN='<MINECRAFT_MCP_TOKEN>' -- npx -y @makkch/minecraft-mcp

What are the best alternatives to Minecraft MCP?

The closest alternatives to Minecraft MCP are Digimon, Disney, Clash Royale, 82-0 Dream MCP and 27-0 MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers