# noddle draw

> noddle draw is an open-source MCP server for design and media. Lets an AI agent read, create, edit and comment on noddle draw diagram boards. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://draw.noddle.dev
- **Repository:** https://github.com/noddle-dev/noddle-draw/tree/HEAD/mcp
- **MCP Registry name:** dev.noddle/draw
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Boards in noddle draw are anonymous: there are no accounts or tokens, and a 12-character board id or a board URL is the only capability. The agent can open any board you give it, and anyone with the link to a board the agent creates can open it too. The agent signs its comments and version snapshots with a configurable display name, so collaborators can tell its work from yours.

The server is a standard-library Python script with nothing to install, speaking stdio. It supports both the 2026-07-28 stateless protocol revision and the older initialize handshake back to 2024-11-05. Besides board reading and editing it can browse version history. A generate_diagram tool can use your own key for Claude, OpenAI, Gemini, OpenRouter or a custom OpenAI-compatible endpoint; the key is sent only to the noddle instance per call and never stored.

By default it talks to draw.noddle.dev, and an environment variable points it at a self-hosted instance. It installs through Claude Code, a Claude Desktop config, a one-click MCP Bundle, or uvx from a checkout.

## Features

- **Anonymous board access:** A board id or URL is the only credential; no accounts or tokens.
- **Read, create and edit:** Works on diagram boards alongside a human collaborator.
- **Version history:** Browse earlier versions; agent snapshots carry its display name.
- **Comments:** Agent comments are signed with a configurable name.
- **Bring-your-own-key generation:** generate_diagram can use Claude, OpenAI, Gemini, OpenRouter or a custom endpoint.
- **Self-hosting support:** Set NODDLE_BASE_URL to point at your own instance.

## Good for

- Have an agent sketch an architecture diagram on a shared board
- Review version history of a board and comment on changes
- Generate a first-draft diagram from a text description
- Work against a self-hosted noddle draw instance

## Install

### Claude Code (Terminal)

```sh
claude mcp add draw --env NODDLE_AI_KEY='<NODDLE_AI_KEY>' -- npx -y https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "draw": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb"
      ],
      "env": {
        "NODDLE_AI_KEY": "<NODDLE_AI_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "draw": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb"
      ],
      "env": {
        "NODDLE_AI_KEY": "<NODDLE_AI_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "draw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb"
      ],
      "env": {
        "NODDLE_AI_KEY": "<NODDLE_AI_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "draw": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb"
      ],
      "env": {
        "NODDLE_AI_KEY": "<NODDLE_AI_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "draw": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb"
      ],
      "env": {
        "NODDLE_AI_KEY": "<NODDLE_AI_KEY>"
      }
    }
  }
}
```

## Tools

- `generate_diagram`: Generate a diagram, optionally with your own AI provider key

## FAQ

### Do I need an account?

No. noddle draw is anonymous, and a board id or URL grants access.

### How do I install it?

Add it to Claude Code with a python3 command, put it in a Claude Desktop or .mcp.json config, or open the noddle-draw.mcpb bundle.

### Can it work with a self-hosted instance?

Yes. Set NODDLE_BASE_URL to your own http(s) origin.

### Where does my AI key go?

It is sent only to the noddle instance with each generate_diagram call and is not stored.

### Is noddle draw free?

Yes. noddle draw is open source, so you can use and self-host it for free.

### How do I add noddle draw to Claude Code?

Run this command in your terminal: claude mcp add draw --env NODDLE_AI_KEY='<NODDLE_AI_KEY>' -- npx -y https://github.com/noddle-dev/noddle-draw/releases/download/mcpb-v1.0.0/noddle-draw.mcpb

### What are the best alternatives to noddle draw?

The closest alternatives to noddle draw are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/noddle-draw
