Skip to content
MCP server

noddle draw

Lets an AI agent read, create, edit and comment on noddle draw diagram boards

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
1.0.0
Listing updated
2 days ago

About noddle draw

noddle draw is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • NODDLE_BASE_URLhttp(s) origin of the noddle draw instance. Set it to your own origin when self-hosting.
  • NODDLE_AGENT_NAMEDisplay name on the agent's comments and version snapshots (max 40 chars).
  • NODDLE_AI_PROVIDEROptional bring-your-own-key provider for generate_diagram.
  • NODDLE_AI_KEYOptional AI provider key, sent only to NODDLE_BASE_URL per call and never stored.
  • NODDLE_AI_MODELOptional model override for generate_diagram.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

noddle draw is MIT licensed; the hosted instance at draw.noddle.dev is anonymous

Prices change. Check draw.noddle.dev before you buy.

noddle draw 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 to noddle draw

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory