mcpylib
Python library for controlling Minecraft servers with python code.
Decision gist · record as of 2026-08-14
Yes, if you are building a non-commercial Minecraft server automation tool or hobby project. The package is actively maintained, has low install friction, and provides a clean API for common server control tasks. However, the non-commercial license is a hard blocker for any monetized or commercial use, and the alpha status means the API and behavior may change. Verify that your target server software supports the remote control API MCPyLib expects before committing to it.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later.
- A running Minecraft server with the appropriate remote control API enabled and a valid authentication token are also required.
- Low install friction with a pure-Python wheel and only one runtime dependency (python-dotenv).
License · maintenance · safety
non-commercial license (noncommercial) — Licensed under a Non-Commercial License. This restricts use to non-commercial purposes only—commercial projects or monetized applications would need explicit permission or an alternative license.
last release 2026-03-11 (156 days) · last repo commit 2026-03-11 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 544,889 downloads/mo, #6,080 on PyPI
Alternatives
Verify before relying
pip install mcpylib
from mcpylib import MCPyLib
mc = MCPyLib(ip="127.0.0.1", port=65535, token="your_token")
mc.setblock(100, 64, 200, "minecraft:diamond_block")
block = mc.getblock(100, 64, 200)
print(f"Block: {block}")- Which Minecraft server software (Bukkit, Spigot, Paper, etc.) or plugin is required to expose the remote control API that MCPyLib connects to.
- Whether the server-side setup and token generation process is documented or straightforward for new users.
- Performance characteristics and latency impact when issuing commands to a remote server.
What it is and what it does
MCPyLib is a client library that connects to a Minecraft server over the network and lets you control it programmatically from Python code. It provides methods to place and query individual blocks, fill regions, teleport players, change game modes, and manipulate world time and weather. The library depends on python-dotenv for configuration management and requires Python 3.11 or later.
The package is in active development (alpha status) with a small but growing user base. It is licensed under a Non-Commercial License, which means it is free to use for personal projects and learning but cannot be used in commercial or monetized applications without explicit permission. The library is straightforward to install and has low dependency friction, making it accessible for hobby Minecraft server automation and scripting.
Use it for
- Automate world-building tasks like filling large regions with blocks or placing structures programmatically.
- Build admin tools that teleport players, change game modes, or manage world time without manual commands.
- Create event systems or game logic that responds to server state by querying player positions and modifying the world.
- Develop testing or validation scripts for Minecraft server configurations and world state.
- Integrate Minecraft server control into a larger application or bot framework for community management.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a non-commercial Minecraft server automation tool or hobby project.
The package is actively maintained, has low install friction, and provides a clean API for common server control tasks. However, the non-commercial license is a hard blocker for any monetized or commercial use, and the alpha status means the API and behavior may change. Verify that your target server software supports the remote control API MCPyLib expects before committing to it.
Install
mcpylib on PyPI
Before you install
Low install friction with a pure-Python wheel and only one runtime dependency (python-dotenv). The package is actively maintained with recent commits, though it is still in alpha status (Development Status :: 3 - Alpha).
Requires Python 3.11 or later. A running Minecraft server with the appropriate remote control API enabled and a valid authentication token are also required.
License in practice
Licensed under a Non-Commercial License. This restricts use to non-commercial purposes only—commercial projects or monetized applications would need explicit permission or an alternative license.
Quickstart
pip install mcpylib
from mcpylib import MCPyLib
mc = MCPyLib(ip="127.0.0.1", port=65535, token="your_token")
mc.setblock(100, 64, 200, "minecraft:diamond_block")
block = mc.getblock(100, 64, 200)
print(f"Block: {block}")Verify before relying
- Which Minecraft server software (Bukkit, Spigot, Paper, etc.) or plugin is required to expose the remote control API that MCPyLib connects to.
- Whether the server-side setup and token generation process is documented or straightforward for new users.
- Performance characteristics and latency impact when issuing commands to a remote server.
Package facts
| License | non-commercial license noncommercial |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepython-dotenv |
| Maintenance | Actively maintained 156 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 544,889 / month, #6,080 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaIntended Audience :: DevelopersProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: mcpylib-1.1.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “minecraft server remote control python”
- mcpylibMCPyLib is a Python client library for remotely controlling Minecraft…
- mcstatusQueries Minecraft servers (Java, Legacy, and Bedrock editions) to…
- nbtlibRead, write, and edit NBT (Named Binary Tag) data files used in…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also mcstatus · nbtlib · amulet-core · amulet-leveldb · music-assistant-client · pysqueezebox · pyblu · yoto-api · aioshelly