Excalidraw MCP for AI Agents

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.

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/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Excalidraw MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Create an Excalidraw diagram showing a deployment pipeline from GitHub to CI, staging, production, and monitoring, then open it in fullscreen editing mode.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Excalidraw MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Excalidraw MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: 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.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Excalidraw MCP actions with your Agent

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

FAQ

Frequently asked questions

No. Excalidraw MCP uses no-auth access, so you don't need to configure OAuth credentials, API keys, or developer tokens. Just create a Composio Tool Router session and your agent can start creating and editing Excalidraw diagrams.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

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