Skip to content
MCP server

CanvasKeep

Create and edit Excalidraw diagrams in your CanvasKeep workspace from an AI client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Web
Runs
Locally
Version
0.6.2
Listing updated
2 days ago

About CanvasKeep

CanvasKeep is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This local server connects an assistant to CanvasKeep, a diagramming service built on the open-source Excalidraw canvas with workspaces, nested folders and version history. It authenticates with an API key from the CanvasKeep dashboard and runs over stdio from npm.

Twelve tools cover managing workspaces and folders, listing, creating, renaming and deleting diagrams, reading a diagram's summary or full scene, saving a scene back, and generate_diagram, which takes nodes and edges and lays them out automatically. A sample request asks for an architecture diagram with a React frontend, Node API, PostgreSQL and Redis.

Encryption affects what the assistant can do. Diagrams you encrypt stay encrypted: the server decrypts and re-encrypts scenes locally with AES-GCM using a master key that never leaves your machine, so the key must be supplied to read or edit them. generate_diagram is the exception, because layout happens on the CanvasKeep server and those diagrams are stored unencrypted. The README shows an MIT licence.

Install

Run in a terminal

claude mcp add canvaskeep-mcp --env CANVASKEEP_API_KEY='<CANVASKEEP_API_KEY>' --env CANVASKEEP_MASTER_KEY='<CANVASKEEP_MASTER_KEY>' -- npx -y canvaskeep-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "canvaskeep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvaskeep-mcp"
      ],
      "env": {
        "CANVASKEEP_API_KEY": "<CANVASKEEP_API_KEY>",
        "CANVASKEEP_MASTER_KEY": "<CANVASKEEP_MASTER_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "canvaskeep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvaskeep-mcp"
      ],
      "env": {
        "CANVASKEEP_API_KEY": "<CANVASKEEP_API_KEY>",
        "CANVASKEEP_MASTER_KEY": "<CANVASKEEP_MASTER_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "canvaskeep-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "canvaskeep-mcp"
      ],
      "env": {
        "CANVASKEEP_API_KEY": "<CANVASKEEP_API_KEY>",
        "CANVASKEEP_MASTER_KEY": "<CANVASKEEP_MASTER_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "canvaskeep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvaskeep-mcp"
      ],
      "env": {
        "CANVASKEEP_API_KEY": "<CANVASKEEP_API_KEY>",
        "CANVASKEEP_MASTER_KEY": "<CANVASKEEP_MASTER_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "canvaskeep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvaskeep-mcp"
      ],
      "env": {
        "CANVASKEEP_API_KEY": "<CANVASKEEP_API_KEY>",
        "CANVASKEEP_MASTER_KEY": "<CANVASKEEP_MASTER_KEY>"
      }
    }
  }
}

Configuration

  • CANVASKEEP_API_KEYAPI key from your CanvasKeep dashboard (profile menu, API Keys)Required
  • CANVASKEEP_MASTER_KEYNeeded to read or edit encrypted diagrams. Copy it from canvaskeep.com/dashboard/encryption
  • CANVASKEEP_API_URLAPI base URL, override for local development

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

list_workspaces
List all workspaces.
create_workspace
Create a new workspace.
list_folders
List folders in a workspace.
create_folder
Create a folder, optionally nested.
list_diagrams
List diagrams in a workspace.
create_diagram
Create a diagram, optionally in a folder.
update_diagram
Rename a diagram.
delete_diagram
Permanently delete a diagram.
get_diagram_summary
Get diagram metadata and element count.
get_diagram_scene
Read the full Excalidraw scene.
save_diagram_scene
Write a full scene back to a diagram.
generate_diagram
Generate a diagram from nodes and edges with auto-layout.

What it does

Auto-layout generation
generate_diagram turns nodes and edges into a laid-out diagram.
Workspaces and folders
List and create workspaces and nested folders.
Full scene access
Read and write the complete Excalidraw scene of a diagram.
Local encryption
Encrypted diagrams are decrypted and re-encrypted on your machine.
Diagram management
Create, rename and permanently delete diagrams.
API key access
Authenticates with a key generated in the CanvasKeep dashboard.

Good for

  • Draw an architecture diagram from a text description
  • Organise generated diagrams into project folders
  • Edit an existing Excalidraw scene programmatically
  • Rename or clean up diagrams in a workspace
  • Keep encrypted diagrams editable by an AI tool

Pricing

Open source

MIT-licensed server; CanvasKeep itself is free to start

Prices change. Check canvaskeep.com before you buy.

CanvasKeep FAQ

What do I need to connect?

An API key from your CanvasKeep dashboard, set as CANVASKEEP_API_KEY.

Can it work on encrypted diagrams?

Yes, with CANVASKEEP_MASTER_KEY set. Decryption happens locally and the key does not leave your machine.

Are generated diagrams encrypted?

No. generate_diagram sends nodes and edges to CanvasKeep for layout, so those diagrams are stored unencrypted.

Is CanvasKeep free?

The site says workspaces, folders and version history are free, with no trial or credit card.

What licence does the server use?

MIT.

How do I add CanvasKeep to Claude Code?

Run this command in your terminal: claude mcp add canvaskeep-mcp --env CANVASKEEP_API_KEY='<CANVASKEEP_API_KEY>' --env CANVASKEEP_MASTER_KEY='<CANVASKEEP_MASTER_KEY>' -- npx -y canvaskeep-mcp

What are the best alternatives to CanvasKeep?

The closest alternatives to CanvasKeep are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to CanvasKeep

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory