MCP Server

Connect Claude to your BoardBuddy board. Manage tasks and projects directly from your AI assistant.

1. Generate an API Key

Open the BoardBuddy app, click the settings icon in the top right, scroll to MCP API Keys, enter a name for the key, and click Generate. Copy the key immediately — it is only shown once.

2. Claude Code

Copy .mcp.json.example to .mcp.json at your project root and fill in your key:

{
  "mcpServers": {
    "boardbuddy": {
      "url": "https://boardbuddy.cloud/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

3. Claude Desktop

Add the following to your Claude Desktop config file, then restart Claude Desktop.

macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Linux ~/.config/Claude/claude_desktop_config.json

Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "boardbuddy": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://boardbuddy.cloud/mcp/sse",
        "--header",
        "Authorization:Bearer YOUR_API_KEY_HERE"
      ]
    }
  }
}

Note: no space between Authorization: and Bearer. Restart Claude Desktop after saving.

Available Tools

list_columns Get the list of available board columns.

list_tasks List your tasks. Filter by project, column, or root-level only.

create_task Create a task or project card in a given column.

update_task Update any fields on an existing task.

delete_task Delete a task. Blocked if it is a project with children.

move_tasks Move one or more tasks to a new column and/or reorder them.

get_project Get a project card and all its child tasks.

get_user_profile Get your BoardBuddy profile.

Troubleshooting

401 Unauthorized Your API key is invalid or revoked. Generate a new one in Settings.

404 Session not found The SSE connection dropped. Restart your MCP client.

Cannot delete project with children Use list_tasks with the project ID, move or delete children first, then delete the project.