JustThreed — control Blender with natural language
JustThreed is a Python MCP server that exposes Blender control tools to any Model Context Protocol (MCP) compatible AI client — Claude Desktop, Claude Code, Gemini CLI, Cursor, VSCode, Ollama, and more. Describe what you want in plain English and watch Blender build it:
"Create a low poly cabin in the woods with warm lighting"
"Add a stone texture to the ground plane"
"Render the scene from a top-down angle"
This package is the AI-client-side half of JustThreed. The other half is a
Blender addon that opens a TCP socket on localhost:9876 and executes the
tool calls against the bpy API. You need both pieces installed for
anything to work — see the full setup guide in the repository.
- Repository & full docs: https://github.com/Phanikondru/justthreed
- Issues: https://github.com/Phanikondru/justthreed/issues
- Sponsor: https://github.com/sponsors/Phanikondru
Quick install
Assuming the Blender addon is already installed and its MCP socket server is running on port 9876, add JustThreed to your AI client's MCP config:
{
"mcpServers": {
"justthreed": {
"command": "uvx",
"args": ["justthreed"]
}
}
}
Or, for Claude Code:
claude mcp add --scope user justthreed -- uvx justthreed
For per-client setup (Claude Desktop, Gemini CLI, Cursor, Ollama, OpenRouter) and the Blender addon install steps, see the main README on GitHub.
How it works
AI Client (Claude / Gemini / Cursor / Ollama / ...)
↓
JustThreed MCP Server (this package) — translates intent to commands
↓
JustThreed Blender addon — socket server on port 9876
↓
Blender (bpy API) — executes in real time
Development
Run against the MCP Inspector (requires the Blender extension running with the MCP Server started):
uv run --with 'mcp[cli]' mcp dev src/justthreed/server.py
Run the server directly (stdio transport — what Claude Desktop does):
uv run justthreed
License
MIT — see LICENSE.
Metadata
Release files for justthreed 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| justthreed-0.1.0.tar.gz | 57.7 kB | Without provenance | Details for justthreed-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| justthreed-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for justthreed-0.1.0-py3-none-any.whl |
Total release size: 76.3 kB
Release files / justthreed-0.1.0.tar.gz
| Download URL | justthreed-0.1.0.tar.gz |
|---|---|
| Size | 57.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bdf55dbe030c19c7c96ea808149fd0d5f9214d30699531b16b4b7eaa90c8c6ca
|
|
BLAKE2b-256 checksum How to use checksums |
cf69e43d39d906e8cd988b8254151d93e964377239b404108025724fdf503632
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / justthreed-0.1.0-py3-none-any.whl
| Download URL | justthreed-0.1.0-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9cc030595297824ad91dd015ee9836c4cde06734ea34dd5b5c8550f643ab5d0
|
|
BLAKE2b-256 checksum How to use checksums |
b4929c497706c3be6d75a963fc99be9d1e71e7afb5a5a4ea9ab4a02171be5c39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for justthreed 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.