CanvasKeep/canvaskeep-mcp

An MCP (Model Context Protocol) server that lets AI tools like Claude Code and Codex generate Excalidraw diagrams and save them directly into your CanvasKeep workspace.
## Setup
### 1. Get an API key
1. Log in to CanvasKeep
2. Click your profile menu (top right) and select API Keys
3. Generate a new key and copy it immediately (you won't see it again)
### 2. Install and register
Claude Code:
bash
claude mcp add canvaskeep \
-e CANVASKEEPAPIKEY=ckyourkeyhere \
-- npx canvaskeep-mcp
Codex / other MCP clients:
json
"mcpServers": {
"canvaskeep": {
"command": "npx",
"args": ["canvaskeep-mcp"],
"env": {
"CANVASKEEPAPIKEY": "ckyourkeyhere"
### 3. Environment variables
| Variable | Required | Default | Description |
| CANVASKEEPAPIKEY | Yes | - | Your API key from the CanvasKeep dashboard |
| CANVASKEEPMASTERKEY | No | - | Needed to read or edit encrypted diagrams. Copy it from canvaskeep.com/dashboard/encryption (Key for the MCP server) |
| CANVASKEEPAPIURL | No | https://canvaskeep.com | API base URL (override for local dev) |
## Available tools
| Tool | Description |
| listworkspaces | List all your workspaces |
| createworkspace | Create a new workspace |
| listfolders | List folders in a workspace |
| createfolder | Create a new folder, optionally nested |
| listdiagrams | List diagrams in a workspace |
| creatediagram | Create a diagram, optionally inside a folder |
| updatediagram | Rename a diagram |
| deletediagram | Permanently delete a diagram |
| getdiagramsummary | Get diagram metadata and element count |
| getdiagramscene | Read the full Excalidraw scene of a diagram |
| savediagramscene | Write a full Excalidraw scene back to a diagram |
| generatediagram | Generate a diagram from nodes and edges with auto-layout |
## Encryption
Diagrams you encrypt in CanvasKeep stay encrypted when an AI tool works with them. When getdiagramscene or savediagramscene touches an encrypted diagram, this server decrypts and re-encrypts it locally (AES-GCM, see src/encryption.ts) using CANVASKEEPMASTERKEY. The master key never leaves your machine.
generatediagram sends the nodes and edges you give it to CanvasKeep, which lays them out on the server, so diagrams generated this way are stored unencrypted.
## Example usage
Ask Claude Code something like:
> "Draw an architecture diagram of a web app with a React frontend, Node API, PostgreSQL database, and Redis cache"