
noddle draw
Lets an AI agent read, create, edit and comment on noddle draw diagram boards
- 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.mcpbAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory