Codex Tldraw MCP - install, status & alternatives [2026]

01 · Install Codex Tldraw MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add jananadiw-codex-tldraw-mcp -- npx -y codex-tldraw-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "jananadiw-codex-tldraw-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "codex-tldraw-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package codex-tldraw-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.jananadiw is GitHub-verified and matches the repo owner

03 · What Codex Tldraw MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can scan a repo and appends a product workflow diagram to /boards/.tldr, scan repository-local JavaScript and TypeScript modules and appends a trackable import graph, list boards under a repo's boards/ directory, and summarize generated diagrams and shape counts.

Capability map

Tools grouped from the project's README - what Codex Tldraw MCP lets an agent do.

Diagram

2 tools - e.g. scans a repo and appends a product workflow diagram to /boards/.tldr.; scans repository-local JavaScript and TypeScript modules and appends a trackable import graph.

diagram_repo · diagram_code_graph

Draw

2 tools - e.g. appends a prompt-provided workflow, state machine, architecture sketch, or plan to /boards/.tldr.; appends a simple codebase architecture view with a main flow, supporting components, actions, calls, and…

draw_canvas · draw_architecture

read & search

2 tools - e.g. lists boards under a repo's boards/ directory.; summarizes generated diagrams and shape counts.

list_boards · read_board_summary

Compare

1 tool - e.g. previews drift or marks changed and stale elements on an existing trackable code graph.

compare_code_graph

Unchanged

1 tool - e.g. the stored identity and fingerprint still match.

unchanged

Changed

1 tool - e.g. the module still exists, but its exports or local import relationships changed.

changed

Stale

1 tool - e.g. the board contains an element that no longer exists in the current code graph.

stale

create & write

1 tool - e.g. the current graph contains an element that is absent from the board.

new

Latest releases

v0.5.0 · 2026-08-05

codex-tldraw-mcp v0.5.0 · Simple runtime architecture diagrams for understanding unfamiliar codebases. · Highlights · Adds draw_architecture, a focused MCP tool for reverse-engineering behavior across browser, API…

v0.4.0 · 2026-07-16

codex-tldraw-mcp v0.4.0 · Code graph drift detection for repo-local tldraw boards. · Highlights · Adds diagram_code_graph for deterministic JavaScript and TypeScript module/import diagrams. · Adds compare_code_graph…

v0.3.0 · 2026-07-11

codex-tldraw-mcp v0.3.0 · Workflow layout update for dense diagrams. · Changes · Wraps node and connector text before rendering. · Sizes nodes from the wrapped text. · Routes connections through separate lanes around…

04 · Who maintains Codex Tldraw MCP

codex-tldraw-mcp is maintained by jananadiw. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/jananadiw/codex-tldraw-mcp
category: automation - ranked #65 of 194 actively-maintained automation servers as of 2026-08-25.
release cadence: 6 releases in the last 90 days (latest 2026-08-05)
registry: io.github.jananadiw/codex-tldraw-mcp (active, first published 2026-07-16 · 2 versions)
packages: npm:codex-tldraw-mcp

06 · Codex Tldraw MCP FAQ

Is Codex Tldraw MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-07 and it shipped 6 releases in the last 90 days. We re-verify nightly.

What can Codex Tldraw MCP do?

With this server connected, an agent can scan a repo and appends a product workflow diagram to /boards/.tldr, scan repository-local JavaScript and TypeScript modules and appends a trackable import graph, list boards under a repo's boards/ directory, and summarize generated diagrams and shape counts.

How do I install Codex Tldraw MCP?

Run `npx -y codex-tldraw-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Codex Tldraw MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Codex Tldraw MCP

Alternatives to Codex Tldraw MCP

Maintained automation servers if Codex Tldraw MCP isn't the fit.

More automation MCP servers · Packet Tracer MCP · Mac OS MCP · Gotify RMCP · Tailscale RMCP · UniFi RMCP (jmagar)

More TypeScript MCP servers · Orca MCP Server · OCI Pricing · Fedlex Connector · Apple Mail MCP (jayvee6) · see all