Drive a local Blender headlessly: inspect, convert, render and script 3D files.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add three-ws-blender --env THREE_WS_FORGE_PROVIDER_KEY='<THREE_WS_FORGE_PROVIDER_KEY>' -- npx -y @three-ws/blender-mcp~/.codex/config.toml
[mcp_servers.three-ws-blender]
command = "npx"
args = ["-y", "@three-ws/blender-mcp"]
env = { THREE_WS_FORGE_PROVIDER_KEY = "<THREE_WS_FORGE_PROVIDER_KEY>" }
# codex mcp add three-ws-blender --env THREE_WS_FORGE_PROVIDER_KEY='<THREE_WS_FORGE_PROVIDER_KEY>' -- npx -y @three-ws/blender-mcp~/.cursor/mcp.json
{
"mcpServers": {
"three-ws-blender": {
"command": "npx",
"args": [
"-y",
"@three-ws/blender-mcp"
],
"env": {
"THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"three-ws-blender": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/blender-mcp"
],
"env": {
"THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"three-ws-blender": {
"command": "npx",
"args": [
"-y",
"@three-ws/blender-mcp"
],
"env": {
"THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"three-ws-blender": {
"command": "npx",
"args": [
"-y",
"@three-ws/blender-mcp"
],
"env": {
"THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"three-ws-blender": {
"command": "npx",
"args": [
"-y",
"@three-ws/blender-mcp"
],
"env": {
"THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
}
}
}
}Environment variables
THREE_WS_FORGE_PROVIDER_KEY
Replace the placeholders with your own credentials and keep them out of version control.