Skip to main content
MCP server CX Codex

BlockHand — Claude Code MCP server: features and setup

BlockHand is an MCP server for Claude Code and Codex that connects an AI agent to Minecraft Education. It controls the Agent robot, builds shapes, and inspects blocks in the world.

MIT ★ 5 updated 2026-11-02

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> --env MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> --transport stdio blockhand -- npx -y @gjlmotea/blockhand-mcp
Open on GitHub

What BlockHand does

BlockHand passes commands between an MCP client and Minecraft Education through the game’s built-in WebSocket connection. It can control the Agent robot, edit blocks, build 24 shapes, read areas, and compare regions. It also checks symmetry and listens for game events.

Minecraft Education must have cheats enabled, and the connecting player needs operator rights. Node.js 22 or newer is required on the machine running the AI client. No game add-on is needed. The WebSocket protocol may change with game updates, so behavior needs another check after an update.

What it helps with

  • build specified shapes in a game world
  • direct the Agent robot and plant crops
  • compare world regions and find symmetry breaks
  • read blocks in a selected area

Example prompts for the agent

  • Call the Agent, move it forward five blocks, and plant a row of wheat.
  • Check the house between coordinates 0 64 0 and 20 80 20 for mirror symmetry, then show the blocks that break it.

How to install BlockHand

Platform CLI

claude mcp add --env MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> --env MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> --transport stdio blockhand -- npx -y @gjlmotea/blockhand-mcp

Replace <…> 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 BlockHand

How do I install BlockHand in Claude Code?

Run claude mcp add blockhand-for-minecraft-education-mcp -- npx -y @gjlmotea/blockhand-mcp, then restart Claude Code.

What does BlockHand do?

It links an MCP client to Minecraft Education so an agent can control the Agent robot, build shapes, inspect blocks, and compare parts of the world.

What does BlockHand need to run?

Minecraft Education must have cheats enabled, the connecting player needs operator rights, and the AI client’s machine needs Node.js 22 or newer.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open