# Minecraft MCP

> Minecraft MCP is an MCP server for games and play. Let an AI agent play in your own Minecraft client, with a stop command for you. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Windows, macOS, Linux
- **Repository:** https://github.com/makkch/minecraft_mcp
- **MCP Registry name:** io.github.MakkCH/minecraft-mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [Digimon](https://ai-powered.com/mcp/digimon): Digimon is a freemium MCP server for games and play.
- [Disney](https://ai-powered.com/mcp/disney): Disney is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [82-0 Dream MCP](https://ai-powered.com/mcp/82-0-dream-mcp): 82-0 Dream MCP is a free MCP server for games and play.
- [27-0 MCP](https://ai-powered.com/mcp/27-0-mcp-2): 27-0 MCP is a free MCP server for games and play.
- [Wynncraft](https://ai-powered.com/mcp/wynncraft): Wynncraft is a freemium MCP server for games and play.
- [Gamechalk Score Keeper](https://ai-powered.com/mcp/gamechalk-score-keeper): Gamechalk Score Keeper is an MCP server for games and play.
- [OSRS Calc MCP](https://ai-powered.com/mcp/osrs-calc-mcp): OSRS Calc MCP is an open-source MCP server for games and play.

---
Source: https://ai-powered.com/mcp/minecraft-mcp
