# CanvasKeep

> CanvasKeep is an open-source MCP server for design and media. Create and edit Excalidraw diagrams in your CanvasKeep workspace from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web
- **Website:** https://canvaskeep.com
- **Repository:** https://github.com/canvaskeep/canvaskeep-mcp
- **MCP Registry name:** io.github.CanvasKeep/canvaskeep-mcp
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/canvaskeep
