Quickstart

By the end of this page, Claude will change your Blender scene while you watch. You’ll add the Blender MCP extension to Blender, log in once through your browser, and type a request in Blender’s own sidebar. Nothing else needs installing.

You need Blender 4.2 or newer and a web browser. Never used Blender? It’s free and takes about ten minutes to install: Get Blender walks you through it.

Install and log in

Do these in Blender. You’re done when the BlenderMCP panel reads Connected · Personal (step 11).

Takes about two minutes in Blender 4.2 or newer. Add this repository once, and Blender keeps the add-on up to date from then on.

https://mcp.blender.bet/install Copy

Step 1 of 12 Open Blender Blender 4.2 or newer, with any scene open.

Step 2 of 12 Edit › Preferences Open the Edit menu and choose Preferences.

Step 3 of 12 Repositories In Get Extensions, open the Repositories menu at the top right.

Step 4 of 12 Add Remote Repository Click + beside the repository list and choose Add Remote Repository.

Step 5 of 12 Paste the address Paste the address above, leave Check for Updates on Startup ticked, and click Create.

Step 6 of 12 Blender MCP appears The repository is added, and Blender MCP shows up under Available.

Step 7 of 12 Install Expand the entry to see what it asks for (network and file access), then click Install. It is about 24 MB with its dependencies bundled.

Step 8 of 12 Installed Blender downloads and enables the add-on. A BlenderMCP tab appears in the 3D viewport sidebar; press N to show it.

Step 9 of 12 Log in Open the BlenderMCP tab and click Login. Your web browser opens.

Step 10 of 12 Approve in the browser Sign in and approve access. Blender waits for you in the meantime.

Step 11 of 12 Connected Back in Blender the panel reads Connected. You can close the browser tab.

Step 12 of 12 Updates When a new version is published, an Update button appears at the top of the panel. One click installs it, with no restart.

Back Next

Add the repository

1. 01 Open Blender
2. 02 Edit › Preferences
3. 03 Repositories
4. 04 Add Remote Repository
5. 05 Paste the address
6. 06 Blender MCP appears

Install

1. 07 Install
2. 08 Installed

Log in

1. 09 Log in
2. 10 Approve in the browser
3. 11 Connected

Afterwards

1. 12 Updates

Note

Installed BlenderMCP from a single file in the past? Remove that copy first, as Install and update the add-on explains, then come back here.

Ask Claude for a change

Below the connection status in the BlenderMCP tab is the Chat panel. New accounts start with a free trial, and the panel shows how much of it is left.

Click the message field, type this, and press Enter:

What's in my Blender scene?

Claude looks at your scene and describes what’s there. On a fresh file that’s the default cube, a camera and a light. Now ask for a change:

Add a sphere next to the cube and make it orange.

Watch the viewport: the sphere appears and turns orange. Each change Claude makes is one Ctrl+Z step, and Undo last chat change takes back a whole reply at once. If Claude needs to run Python, the panel shows the code first and waits for Allow or Deny.

Chat inside Blender covers the rest: clipping objects to a message, the Reader, and choosing a model.

When the free trial runs out

When the trial is used up, or any time you click Use my own key, the panel asks for a Claude API key. No key? The box’s How to connect button explains how to use Claude Desktop or Claude Code on your Claude plan instead.

Paste a key, or connect Claude Desktop or Claude Code instead.

A key that doesn’t work is turned away before it’s saved.

1. Click Get a key. It opens Settings › API keys in the Claude Console. Sign in, or create an account if you don’t have one, then click Create key. The Console shows the key, which starts with sk-ant-, only once, so copy it right away.

2. Paste the key into the field in the Chat panel and click Save key.

3. The server checks the key with Anthropic before saving it, then the box closes and you can carry on where you left off.

Your key is sent to the server once and stored there encrypted. It is never saved in Blender’s preferences or your .blend file, and from then on your requests are billed to your Anthropic account. To remove it, open Edit › Preferences › Add-ons › Blender MCP and click Clear backend under Chat backend.

For every step in detail, including changing the model and what to do if a key is turned away, see Use your own Claude API key.

Use Claude Code or Claude Desktop too (optional)

The same server works with other MCP clients, which helps when you’d rather drive Blender from the tools you already use. It’s also the way to keep going after the free trial without an API key: Claude Desktop and claude.ai can add the server as a custom connector on every Claude plan, including Free (which allows one custom connector). Your client connects to https://mcp.blender.bet/, exactly as written with no /mcp on the end, and signs in with the same account you used in Blender. The server only shows a client the Blenders logged in as the same person, so a different account finds nothing to talk to.

Claude Code

claude mcp add --transport http blender https://mcp.blender.bet/

Start Claude Code, type /mcp, pick blender, and authenticate. Your browser opens the same sign-in page you saw from Blender.

Claude Desktop / claude.ai

1. Open Settings › Connectors and click Add custom connector.

2. Name it Blender and enter https://mcp.blender.bet/ as the URL.

3. Click Connect and sign in through the browser.

Then ask the same questions as above in that client. These clients use your own Claude plan, not the Chat panel’s trial or an API key.

Next steps

Chat inside Blender Clip objects to a message, approve Python, undo a reply, choose the model.

Add your own tools Give Claude extra tools, such as a PDF reader, running next to Blender.

Install and update the add-on One-click updates, and moving off an old single-file install.

Use it from CI or scripts Personal access tokens for jobs that can't open a browser.