{
  "markdown": "# @cmd8/excalidraw-mcp\n\nModel Context Protocol (MCP) server for Excalidraw diagrams.\n\n## 🛠️ Installation\n\n### Requirements\n\n- Node.js >= v18.0.0\n\n<details>\n<summary><b>Install in Cursor</b></summary>\n\nAdd to your Cursor MCP config (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"excalidraw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cmd8/excalidraw-mcp\", \"--diagram\", \"/path/to/diagram.excalidraw\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Claude Code</b></summary>\n\n```sh\nclaude mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw\n```\n\n</details>\n\n<details>\n<summary><b>Install in Amp</b></summary>\n\n```sh\namp mcp add excalidraw -- npx -y @cmd8/excalidraw-mcp --diagram /path/to/diagram.excalidraw\n```\n\n</details>\n\n<details>\n<summary><b>Install in VS Code</b></summary>\n\nAdd to your VS Code MCP settings:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"excalidraw\": {\n        \"type\": \"stdio\",\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@cmd8/excalidraw-mcp\", \"--diagram\", \"/path/to/diagram.excalidraw\"]\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Windsurf</b></summary>\n\nAdd to your Windsurf MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"excalidraw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cmd8/excalidraw-mcp\", \"--diagram\", \"/path/to/diagram.excalidraw\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Claude Desktop</b></summary>\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"excalidraw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cmd8/excalidraw-mcp\", \"--diagram\", \"/path/to/diagram.excalidraw\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in OpenAI Codex</b></summary>\n\nAdd to your Codex MCP config:\n\n```toml\n[mcp_servers.excalidraw]\ncommand = \"npx\"\nargs = [\"-y\", \"@cmd8/excalidraw-mcp\", \"--diagram\", \"/path/to/diagram.excalidraw\"]\n```\n\n</details>\n\n## CLI Options\n\n- `-d, --diagram` (required): Path to the Excalidraw diagram file\n\n## 🔨 Available Tools\n\n### `createNode`\n\nCreate a new node (shape with label) in the diagram. Returns the created node ID.\n\n### `createEdge`\n\nCreate an arrow connecting two nodes. Nodes can be referenced by ID or by label text.\n\n### `deleteElement`\n\nDelete a node or edge from the diagram by ID or label.\n\n### `getFullDiagramState`\n\nReturns a markdown representation of the complete diagram, including nodes, relationships, labels, frames, and colors.\n\n## License\n\nMIT\n",
  "bytes": 2491,
  "sha": "5c39dc050c027b86c0dfaf07a5c8b2b12364a7e878e3fe29d8c4232ec7061c75",
  "repo_slug": "cmd8/excalidraw-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cmd8_excalidraw_mcp_2b756da6/readme"
}