Cursor × Blender MCP

How to Connect Cursor to Blender Using MCP

Connect Cursor to Blender and keep your 3D workflow close to your code.

Before you begin

Prerequisites

Do it in order

Step-by-Step

01

Install Blender MCP Addon

Download the add-on .zip from the MCP server project you trust. In Blender, open Preferences → Add-ons → Install and select the downloaded archive.

Enable the add-on and leave Blender open while you complete the connection.

Blender Preferences add-on installation placeholderBlender Preferences add-on installation placeholder
02

Enable MCP in Cursor Settings

Open Cursor settings and locate Apps, Connectors, or Developer Mode. Enable MCP access before adding the connection.

For ChatGPT, this requires an eligible plan and a remote MCP app; ChatGPT cannot connect directly to a local server.

Cursor settings placeholderCursor settings placeholder
03

Configure the MCP JSON

Use this as the server-side connection record or as a reference while you register your remote MCP app. Replace the example hostname with your deployed Blender MCP bridge URL.

Do not publish a private token or an unauthenticated Blender endpoint.

{
  "mcpServer": {
    "transport": "streamable-http",
    "url": "https://YOUR_PUBLIC_BLENDER_MCP_HOST/mcp"
  }
}
04

Launch Blender and Test Connection

Start Blender, then call a harmless read-only tool such as scene information from your AI client. Confirm the request is visible in the add-on logs.

Only allow modifying tools after the read-only path works reliably.

Successful connection status placeholderSuccessful connection status placeholder
05

Your First AI-Generated 3D Scene

Begin with a small, reversible request and inspect every object in Blender before rendering or saving.

Once the scene is correct, iterate on materials, camera framing, and animation one request at a time.

Create a low-poly orange chair on a simple studio floor.\nUse a three-point light setup and name the main object "OrangeChair".

Fix it fast

Troubleshooting

Connection refused+

Confirm Blender is running, the add-on bridge uses the expected port, and your remote MCP service can reach it. Check firewall and tunnel logs before retrying.

Addon not showing up+

Verify that you selected the downloaded .zip in Blender Preferences, enabled the add-on, and installed a version compatible with your Blender release.

Cursor says tool not found+

Re-open the app or connector configuration, scan or refresh tools if available, and confirm the remote endpoint returns its MCP tool list over HTTPS.

Blender crashes on launch+

Disable the add-on, open Blender normally, then install the latest compatible add-on version. Test with a new empty file before reopening production work.

Guide-specific answers

Cursor FAQ

Can I use Cursor with a local Blender MCP server?+

Desktop MCP clients can often use a local server. Browser-based ChatGPT connections require a remote MCP endpoint; use a secure tunnel or hosted bridge rather than localhost.

Is the guide free?+

This guide is free. Your Blender add-on, AI plan, and any hosting or tunnel service can have separate costs and terms.

Is it safe to let an AI control Blender?+

Treat it as a powerful automation tool: use trusted servers only, start with read-only tools, review generated changes, and save a copy before modification actions.