Vela MCP Server

An MCP (Model Context Protocol) server for interacting with Vela Whiteboard programmatically.

Installation

``bash
npm install -g vela-mcp-server
`

Configuration

Get your API token from velaboard.com/settings.

Usage with Claude Code

`bash
claude mcp add vela -e VELA_API_TOKEN=vela_xxx -- vela-mcp
`

Usage with Claude Desktop

Add to your claude_desktop_config.json:

`json
{
"mcpServers": {
"vela": {
"command": "vela-mcp",
"env": {
"VELA_API_TOKEN": "vela_your_token_here"
}
}
}
}
`

Available Tools

$3

| Tool | Description |
|------|-------------|
| list_projects | List all your Vela projects |
| get_project | Get project details with all boards, items, and connections |
| create_project | Create a new project |
| update_project | Update project name, description, or visibility |
| delete_project | Delete a project (cannot be undone) |

$3

| Tool | Description |
|------|-------------|
| list_boards | List all boards in a project |
| create_board | Create a new board within a project |

$3

| Tool | Description |
|------|-------------|
| list_items | List all items in a project (optionally filtered by board) |
| get_item | Get details of a specific item |
| create_item | Create a card, note, or image |
| update_item | Update item position, size, text, color, etc. |
| delete_item | Delete an item |

Examples

$3

`
Use the list_projects tool to show all my Vela whiteboards.
`

$3

`
Create a card on board "main" in project [id] at position (100, 100) with text "Hello World".
`

$3

`
In project [id], create cards for: "Start", "Process", "Decision", "End"
arranged in a vertical flowchart layout starting at (200, 100).
`

Item Types

- card: Clickable cards that can contain nested boards. Good for organizing ideas hierarchically.
- note: Sticky notes with a colored background. Good for annotations and quick thoughts.
- image: Image items (currently read-only via API).

Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| VELA_API_TOKEN | Your Vela API token (required) | - |
| VELA_BASE_URL | API base URL | https://velaboard.com` |

License

MIT