How to Set Up Blender MCP in Cursor (2026 Guide)

Yes, you can use MCP with Cursor. Cursor has native support for MCP servers, making it one of the best IDEs for AI-powered 3D modeling with Blender. This guide walks you through the complete setup — from installing dependencies to creating your first 3D model.

Cursor’s MCP integration means you can use Blender MCP as either a global server (available in all projects) or a project-specific server. The setup takes about 5 minutes.

Prerequisites

• Blender 3.0+ — Download from blender.org 
• Cursor IDE — Download from cursor.com 
• uv package manager — Required for running the MCP server

Step 1: Install uv Package Manager

brew install uv

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

curl -LsSf https://astral.sh/uv/install.sh | sh

Step 2: Add the MCP Server in Cursor

You have two options — global server or project-specific.

Option A: Global MCP Server (Recommended)

Go to Cursor Settings → MCP and click “Add new global MCP server”. Paste this config:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

{
  "mcpServers": {
    "blender": {
      "command": "cmd",
      "args": ["/c", "uvx", "blender-mcp"]
    }
  }
}

Option B: Project-Specific Server

Create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

{
  "mcpServers": {
    "blender": {
      "command": "cmd",
      "args": ["/c", "uvx", "blender-mcp"]
    }
  }
}

Step 3: Install the Blender Addon

Step 4: Connect and Start Building

How to See MCP in Cursor

To verify the MCP server is connected:

1. Go to Cursor Settings → MCP — you should see “blender” listed with a green status
2. In the Agent chat, MCP tools will appear in the tool list
3. If the status shows red/disconnected, try restarting Cursor

What Does MCP Enable in Cursor?

With Blender MCP connected, Cursor’s AI agent can:

• Create and modify 3D objects — meshes, materials, lighting
• Inspect your Blender scene — get object lists, material data, scene structure
• Download assets — Poly Haven HDRIs/textures/models, Sketchfab models
• Generate 3D models — via Hyper3D Rodin and Hunyuan3D
• Execute Python code — run any Blender Python script
• Take viewport screenshots — the AI can see your current scene

This is different from using Cursor for coding — the MCP tools give Cursor direct access to Blender’s 3D environment.

Troubleshooting

MCP server shows red/disconnected in Settings

• Verify uv is installed: uv --version
• On Windows, make sure the config uses cmd + /c wrapper
• Restart Cursor after adding the config
• Check that no other MCP client (Claude Desktop) is already connected

Blender connection fails

• Make sure the BlenderMCP addon is enabled and the “Connect” button has been clicked
• Check that port 9876 is not blocked by a firewall
• Try restarting Blender and reconnecting

First command times out

Known quirk — the first command sometimes fails. Send a second message and it typically works.

Performance with large scenes

For complex scenes, break requests into smaller steps. Cursor handles sequential tool calls well, so multi-step prompts are often more reliable than single complex ones.

For a deep dive on how the server works, see our MCP Server architecture guide.