Control a Minecraft client with the Minecraft MCP mod and JsMacros Reloaded.
Connect Runs on your machine
claude mcp add minecraft-mcp -e MINECRAFT_MCP_TOKEN=<MINECRAFT_MCP_TOKEN> -e MINECRAFT_MCP_PORT=<MINECRAFT_MCP_PORT> -e MINECRAFT_MCP_URL=<MINECRAFT_MCP_URL> -- npx -y @makkch/[email protected]
{
"mcpServers": {
"minecraft-mcp": {
"command": "npx",
"args": [
"-y",
"@makkch/[email protected]"
],
"env": {
"MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>",
"MINECRAFT_MCP_PORT": "<MINECRAFT_MCP_PORT>",
"MINECRAFT_MCP_URL": "<MINECRAFT_MCP_URL>"
}
}
}
}
{
"mcpServers": {
"minecraft-mcp": {
"command": "npx",
"args": [
"-y",
"@makkch/[email protected]"
],
"env": {
"MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>",
"MINECRAFT_MCP_PORT": "<MINECRAFT_MCP_PORT>",
"MINECRAFT_MCP_URL": "<MINECRAFT_MCP_URL>"
}
}
}
}
{
"servers": {
"minecraft-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@makkch/[email protected]"
],
"env": {
"MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>",
"MINECRAFT_MCP_PORT": "<MINECRAFT_MCP_PORT>",
"MINECRAFT_MCP_URL": "<MINECRAFT_MCP_URL>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MINECRAFT_MCP_TOKENRequired, secret | Token shown in the Minecraft MCP mod settings (F8). |
MINECRAFT_MCP_PORTOptional | Port shown in the Minecraft MCP mod settings. |
MINECRAFT_MCP_URLOptional | Optional HTTP(S) game bridge base URL, including a proxy path prefix. Overrides MINECRAFT_MCP_PORT. The MCP process stays on the agent computer. |
Details
| Package | @makkch/[email protected] (NPM, stdio) |
| First published | 13 Nov 2026 |
| Last updated | 13 Nov 2026 |
| Registry name | io.github.MakkCH/minecraft-mcp |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
