Control a Mineflayer Minecraft bot with 120+ MCP tools: move, mine, craft, fight, build, and see.
Connect Runs on your machine
claude mcp add awesome-mineflayer-mcp -e MCP_DEFAULT_HOST=<MCP_DEFAULT_HOST> -e MCP_DEFAULT_USERNAME=<MCP_DEFAULT_USERNAME> -e MCP_DEFAULT_AUTH=<MCP_DEFAULT_AUTH> -e MCP_DISABLE_GROUPS=<MCP_DISABLE_GROUPS> -e MCP_READ_ONLY=<MCP_READ_ONLY> -e MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> -- npx -y [email protected]{
"mcpServers": {
"awesome-mineflayer-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_DEFAULT_HOST": "<MCP_DEFAULT_HOST>",
"MCP_DEFAULT_USERNAME": "<MCP_DEFAULT_USERNAME>",
"MCP_DEFAULT_AUTH": "<MCP_DEFAULT_AUTH>",
"MCP_DISABLE_GROUPS": "<MCP_DISABLE_GROUPS>",
"MCP_READ_ONLY": "<MCP_READ_ONLY>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}{
"mcpServers": {
"awesome-mineflayer-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_DEFAULT_HOST": "<MCP_DEFAULT_HOST>",
"MCP_DEFAULT_USERNAME": "<MCP_DEFAULT_USERNAME>",
"MCP_DEFAULT_AUTH": "<MCP_DEFAULT_AUTH>",
"MCP_DISABLE_GROUPS": "<MCP_DISABLE_GROUPS>",
"MCP_READ_ONLY": "<MCP_READ_ONLY>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}{
"servers": {
"awesome-mineflayer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MCP_DEFAULT_HOST": "<MCP_DEFAULT_HOST>",
"MCP_DEFAULT_USERNAME": "<MCP_DEFAULT_USERNAME>",
"MCP_DEFAULT_AUTH": "<MCP_DEFAULT_AUTH>",
"MCP_DISABLE_GROUPS": "<MCP_DISABLE_GROUPS>",
"MCP_READ_ONLY": "<MCP_READ_ONLY>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}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 |
|---|---|
MCP_DEFAULT_HOSTOptional | Server to auto-connect on startup (optional). |
MCP_DEFAULT_USERNAMEOptional | In-game name (offline) or account email (microsoft). |
MCP_DEFAULT_AUTHOptional | Auth mode: offline or microsoft. |
MCP_DISABLE_GROUPSOptional | Comma-separated tool-group keys to disable. |
MCP_READ_ONLYOptional | Observe-only mode (no world-mutating tools). |
MCP_ALLOWED_HOSTSOptional | Comma-separated allow-list of hosts the bot may join. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 29 Jun 2026 |
| Last updated | 29 Jun 2026 |
| Registry name | io.github.G0Osey99/awesome-mineflayer-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.