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.

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.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Excalidraw connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

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

When you connect a Excalidraw account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Excalidraw as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Excalidraw. If Excalidraw lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Excalidraw at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Excalidraw connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio's free plan includes 100,000 tool calls per month with no credit card, which covers most personal Excalidraw use. Paid plans add higher limits and team features. Your Excalidraw plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Excalidraw accounts).

With Composio, you connect Excalidraw once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

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