Vi3W
Skip to content

Guides

Blender MCP not working: how to fix 'not connecting', a missing tab and timeouts

Blender MCP not working, not connecting, tab not showing or timing out? A step-by-step checklist for the official and community MCP servers.

4 min read

A blue plug and a violet plug about to connect to a small glowing crystal module
Illustration. Most Blender MCP failures are a connection that never started.

Quick answer

Why is Blender MCP not working?

Usually one of four things: the add-on is installed but not enabled, the server inside Blender was never started, your AI client wasn't fully restarted after the config change, or two clients are fighting over the same port. Fix those in that order, then test with a simple read-only request.

First: which Blender MCP are you using?

The fixes differ slightly between the two servers:

  • Official Blender MCP (Blender Lab, used by Claude's Blender connector). Controls live in the add-on's preferences panel: host, port, auto-start, start/stop.
  • MCP for Blender (community, formerly "Blender MCP"). Controls live in a sidebar tab: press N in the 3D Viewport, open MCP for Blender, click Start MCP Server.

Not sure which you installed? Look in Edit ‣ Preferences ‣ Add-ons and search "MCP". Background: Blender MCP explained.

Blender MCP not connecting: the checklist

Work through these in order. Most "not connecting" reports end at step 2 or 3.

  1. Is the add-on enabled? Installed isn't enabled. Tick its checkbox in Preferences ‣ Add-ons.
  2. Is the server started inside Blender? For the community add-on, click Start MCP Server in the N panel every session. For the official add-on, start it in preferences or turn on auto-start.
  3. Did you fully restart the AI client? Claude Desktop, Cursor and similar apps only read MCP config at launch. Quit from the menu bar or tray, not just the window.
  4. Is only one client connected? The community project says to run one MCP client (Claude Desktop or Cursor) at a time.
  5. Is the config valid? One missing comma in the JSON and the client silently skips the server. Paste it into a JSON validator.
  6. Is uv installed the right way? The community server runs through uvx; install uv with its official installer (Homebrew on macOS, winget on Windows), not pip install uv.
  7. Is online access allowed? Some add-ons respect Preferences ‣ System ‣ Allow Online Access. The official project's local-LLM guide says to enable it.

Blender MCP tab not showing

  • Press N with the mouse over the 3D Viewport; the sidebar toggles.
  • Check the add-on is enabled and that its name matches what your tutorial expects. The community project renamed its add-on to Interface: MCP for Blender in September 2026, so older videos show a different name.
  • The official add-on doesn't need a sidebar tab; look in its preferences.
  • Your Blender may be too old. The community add-on needs Blender 3.0 or newer; the official project's local-LLM setup lists Blender 5.1.

Blender MCP not responding or timing out

  • Split the request. "Build a whole village" generates huge scripts that time out. Ask for one building, check, continue.
  • Large downloads freeze Blender. The community add-on downloads Poly Haven assets on Blender's main thread, so the UI can hang until the transfer finishes. Ask for lower resolutions.
  • Heavy scenes are slow. Screenshot and summary tools have more to do in big files. Hide or disable collections you aren't working on.
A blue plug and a violet plug about to connect
Illustration. Check both ends: the server in Blender and the client config.

Blender MCP not installing

  • Install from Disk wants the .zip. Don't unzip add-ons before installing.
  • Extension builds. The official add-on can be built and installed as a Blender extension (blender -c extension build then install-file), per its repo.
  • Python errors in the console. Open Window ‣ Toggle System Console on Windows, or start Blender from a terminal on macOS/Linux, and read the first error.

Tools appear, but nothing happens in Blender

  • The client is connected to the MCP process, but the process can't reach Blender. Restart the server inside Blender, then retry.
  • Check host and port in the add-on preferences match what the server expects (both default to local).
  • If you run Blender inside a VM, which the official project recommends for safety, make sure the client and Blender can reach each other.

Still stuck?

Try the other server. If the official one fails on your Blender version, the community one may work, and vice versa. And remember the goal: if you only need models in your scene, you can skip MCP entirely. Generate them in Vi3W, export GLB, and import with File ‣ Import ‣ glTF 2.0. Try Vi3W.

Frequently asked questions

blender mcp not connecting

Start the server inside Blender first, then fully quit and reopen your AI client so it relaunches the MCP process. Make sure only one client is connected and nothing else is using the add-on's port.

blender mcp tab not showing

The add-on isn't enabled, or you're looking in the wrong place. Enable it in Edit, Preferences, Add-ons, then press N in the 3D Viewport to open the sidebar. The official add-on keeps its controls in its preferences panel instead of a sidebar tab.

claude blender mcp not working

Quit Claude Desktop completely (from the tray or menu bar, not just the window), check the JSON in Edit Config is valid, then reopen. If tools appear but calls fail, restart the server in Blender.

Last reviewed