# noddle draw MCP server

> Lets an AI agent read, create and edit anonymous noddle draw diagram boards, browse version history, add comments and generate diagrams from text.

- Repository: https://github.com/noddle-dev/noddle-draw
- Page: https://hostedmcp.org/servers/noddle-dev/draw
- Transport: stdio
- Stars: 18
- License: MIT
- Latest version: 1.0.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `NODDLE_AI_KEY` | no | yes | Optional AI provider key, sent only to NODDLE_BASE_URL per call and never stored. |
| `NODDLE_AGENT_NAME` | no | no | Display name on the agent's comments and version snapshots (max 40 chars). |
| `NODDLE_AI_MODEL` | no | no | Optional model override for generate_diagram. |
| `NODDLE_AI_PROVIDER` | no | no | Optional bring-your-own-key provider for generate_diagram. |
| `NODDLE_BASE_URL` | no | no | http(s) origin of the noddle draw instance. Set it to your own origin when self-hosting. |

## Tools (9)

- `get_board`
- `create_board`
- `update_board`
- `rename_board`
- `list_versions`
- `get_version`
- `list_comments`
- `add_comment`
- `generate_diagram`

## FAQ

### Does the noddle draw MCP server need an API key or account?

No. noddle draw is anonymous: there are no accounts and no tokens. A board id or board URL acts as the capability to open and edit a board.

### Can the MCP server list or delete my boards?

No. There is no list_boards and no delete tool because the API supports neither; link access is not discovery.

### How do I install the noddle draw MCP server in Claude Code?

Run claude mcp add noddle -- python3 mcp/noddle_mcp.py from the repo root, optionally setting NODDLE_BASE_URL for a self-hosted instance.

### Can the server generate a diagram from a text prompt?

Yes. generate_diagram turns prose or Mermaid into diagram JSON via the instance's AI, either your own BYOK key or the shared pool, but it saves nothing so you pass the result to create_board or update_board.

### How do I avoid overwriting a concurrent edit when updating a board?

Pass expected_updated_at to update_board so a concurrent edit returns a conflict error instead of overwriting. Each update also keeps a version snapshot.
