How to Run Blender MCP on Windows 11 (with Cursor)

Having trouble getting Blender MCP to work with Cursor on Windows 11? This guide walks you through the steps to fix compatibility issues and ensure a smooth workflow. Learn how to configure MCP, troubleshoot errors, and optimize your setup for seamless motion capture in Blender.

Emmanuel Mumba

Emmanuel Mumba

24 March 2025

How to Run Blender MCP on Windows 11 (with Cursor)

Blender MCP is an essential tool for integrating Blender with tools such as Cursor, allowing developers to streamline their workflow. However, many users experience issues, such as the Client Closed error, when trying to get MCP to work on Windows 11.

This guide covers everything you need to know about MCP, its setup process, and how to troubleshoot common issues.

💡
If you're looking to streamline your API development and testing, Apidog offers a comprehensive platform for API design, testing, and documentation. Just like Blender MCP helps automate motion capture workflows, Apidog brings automation to API development, making your process faster and more efficient.
button

What is MCP?

MCP (Modular Code Processing) is a system that allows Cursor to interact with external applications like Blender. It enables automation, scripting, and AI-powered interactions within Blender, making it easier to handle tasks such as:

In short, MCP acts as a bridge between Cursor and Blender, allowing smoother integration and increased productivity.


Blender + MCP, the Magic for Coding

If you’re a developer or designer using Blender, MCP with Cursor provides several benefits:
- AI-Powered Development – Write and execute scripts more efficiently.
- Seamless Integration – Automate Blender tasks directly from Cursor.
- Faster Workflow – Avoid switching between multiple tools by using a single interface.

However, due to some compatibility issues with Windows 11, getting Blender MCP to work properly requires some manual setup.

💡
Hyped my MCP Servers? Want to find all MCP Servers in one place?

Visit himcp.ai, a platform dedicated to discovering awesome MCP servers and clients!

Common Issue: ‘Client Closed’ Error in Windows 11

Many users report that MCP fails to start properly, showing a ‘Client Closed’ error. The primary reasons for this include:
- Incorrect Path Configuration – The MCP configuration file does not point to the correct directory.
- Missing uv Package Manager – MCP requires uv to function correctly.
- Firewall/Antivirus Restrictions – Security settings may block MCP’s connection.

Follow the steps below to fix these issues and ensure Blender MCP runs smoothly on Windows 11.


Step 1: Install uv Package Manager

Before configuring Blender MCP, you need to install uv, which is required for managing the MCP dependencies.

Installing uv on Windows 11

Open PowerShell or Command Prompt with administrator privileges.

Run the following command:

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

Restart your computer to apply changes.

To verify the installation, run:

uv --version

If the command returns a version number, uv is installed successfully.


Step 2: Configure the MCP Settings

Blender MCP requires a configuration file (mcp.json) to specify the correct executable path.

Editing mcp.json

Navigate to your Cursor configuration directory.

Locate the mcp.json file. If it doesn’t exist, create one.

Open it in a text editor like VS Code or Notepad++.

Add the following configuration:

{
  "mcpServers": {
    "blender": {
      "command": "C:\\Users\\<your-username>\\.local\\bin\\uvx.exe",
      "args": ["blender-mcp"]
    }
  }
}

Save and close the file.


Step 3: Restart and Refresh Cursor

After updating your configuration, follow these steps:

  1. Restart your PC to apply changes.
  2. Open Cursor and check if Blender MCP is listed under available integrations.
  3. If MCP doesn’t appear:
  1. If everything is set up correctly, you should see a green indicator next to Blender MCP, confirming that it is running properly.

Step 4: Additional Troubleshooting

If MCP still doesn’t work, try these fixes:

1. Run Cursor as Administrator

Some features require elevated permissions to work properly.

2. Reinstall MCP

If MCP is missing or corrupted, reinstall it using:

uv install blender-mcp

3. Check Firewall & Antivirus Settings

Windows Firewall or antivirus software may block MCP’s connection.


Step 5: Verify MCP is Working

Once everything is set up, test MCP by running a simple script in Cursor.

Open Cursor and create a new Blender script.

Copy and paste this Python command:

import bpy
bpy.ops.mesh.primitive_cube_add()

Run the script and check if a cube appears in Blender.
-  If the script executes successfully, MCP is fully operational!

💡
While Blender MCP enhances automation for Blender, if you're working with APIs, Apidog offers a powerful all-in-one API design, testing, and documentation platform
button

Conclusion

Setting up Blender MCP on Windows 11 can be tricky, but by following this guide, you should have a fully functional integration between Cursor and Blender.

Key Takeaways:

✔ Install uv to manage MCP dependencies.
✔ Update mcp.json with the correct path to uvx.exe.
✔ Restart Cursor and your PC to apply the changes.
✔ Troubleshoot issues by checking permissions, reinstalling MCP, and adjusting firewall settings.

With these steps, you can now seamlessly use Blender MCP within Cursor, unlocking powerful automation and AI-assisted workflows.

Explore more

15 Best Open-Source RAG Frameworks in 2025

15 Best Open-Source RAG Frameworks in 2025

Large Language Models (LLMs) are revolutionary, but they have a fundamental limitation: their knowledge is frozen in time, limited to the data they were trained on. They can't access your private documents, query real-time data, or cite their sources. This is where Retrieval-Augmented Generation (RAG) comes in. RAG is the architectural pattern that gives LLMs a superpower: the ability to retrieve relevant information from external knowledge bases before answering a question. This simple but pow

6 June 2025

Stagehand Review: Best AI Browser Automation Framework?

Stagehand Review: Best AI Browser Automation Framework?

Browser automation has long been a cornerstone of modern software development, testing, and data extraction. For years, frameworks like Selenium, Puppeteer, and more recently, Playwright, have dominated the landscape. These tools offer granular control over browser actions, but they come with a steep learning curve and a significant maintenance burden. Scripts are often brittle, breaking with the slightest change in a website's UI. On the other end of the spectrum, a new wave of AI-native agents

6 June 2025

15 Best Browser Automation Tools for Web Testing and Scraping in 2025

15 Best Browser Automation Tools for Web Testing and Scraping in 2025

The world of web automation is in the middle of a seismic shift. For years, the landscape was dominated by powerful-but-complex frameworks that demanded deep coding knowledge. Today, a new generation of AI-driven tools is emerging, promising to make automation more intuitive, resilient, and accessible than ever before. In 2025, the best tool is no longer just about having the most features; it's about providing the right balance of control, flexibility, and intelligence for the task at hand. Wh

6 June 2025

Practice API Design-first in Apidog

Discover an easier way to build and use APIs