Excalidraw MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Excalidraw MCP or direct API to create hand-drawn diagrams, edit scenes, control the viewport camera, and open fullscreen editing through natural language.

Excalidraw MCP logoExcalidraw MCP
No Auth

Excalidraw MCP is a no-auth MCP server for creating hand-drawn style diagrams in Excalidraw. Use it to generate visual sketches with viewport camera control and fullscreen editing.

5 Tools

Try Excalidraw MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Excalidraw MCP
Try asking
TOOLS

Supported Tools

Every Excalidraw MCP action and event your agent gets out of the box.

Create view

Renders a hand-drawn diagram using Excalidraw elements.

Export to excalidraw

Upload diagram to excalidraw.com and return shareable URL.

Read checkpoint

Read checkpoint state for restore.

Read me

Returns the Excalidraw element format reference with color palettes, examples, and tips.

Save checkpoint

Update checkpoint with user-edited state.

SETUP GUIDE

Connect Excalidraw MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["excalidraw_mcp"],
  mcp: true,
});
Create a session scoped to Excalidraw MCP and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Create an Excalidraw diagram showing a user signup flow with frontend, API, database, and email verification, then fit it to the viewport.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Excalidraw MCP request
SETUP GUIDE

Connect Excalidraw MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["excalidraw_mcp"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Excalidraw MCP
3

Run Excalidraw MCP tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Create an Excalidraw diagram showing a user signup flow with frontend, API, database, and email verification, then fit it to the viewport." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Excalidraw MCP tool calls through the session, and print the final answer

Why Use Composio?

AI Native Excalidraw MCP Integration

  • Supports both Excalidraw MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable diagram creation and editing
  • Rich coverage for creating scenes, adjusting the viewport, and launching fullscreen editing

Managed Auth

  • No OAuth flow or API key setup needed for Excalidraw MCP because it uses no-auth access
  • Composio still gives you a central place to manage agent sessions and tool access
  • No hard-coded credentials, no token refresh work, and no auth plumbing to maintain

Agent Optimized Design

  • Tools are shaped for AI agents to create diagrams from plain language prompts
  • LLM-friendly inputs help agents place elements, update scenes, and control camera view more reliably
  • Comprehensive execution logs so you can see what diagram action ran, when, and for which user

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Excalidraw MCP
  • Scoped access to Excalidraw MCP tools, including scene creation and viewport operations
  • Full audit trail of agent actions to support review, debugging, and compliance
FRAMEWORKS

Use Excalidraw MCP with any AI Agent Framework

Choose a Framework you want to connect Excalidraw MCP with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Excalidraw MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Excalidraw MCP tool your agent needs.Free to start.

Start building