@flowboardlabs/mcp-server

MCP (Model Context Protocol) server for FlowBoard — lets AI tools like Claude Code, Cursor, and other MCP-compatible assistants manage your projects, tasks, ideas, and releases directly from your IDE.

Setup

1. Get an API Key

Go to Settings > Integrations > API Keys in your FlowBoard workspace. Click "Generate API Key" and copy it.

2. Configure Your AI Tool

Add the following to your MCP server configuration:

macOS / Linux:

{
  "mcpServers": {
    "flowboard": {
      "command": "npx",
      "args": ["-y", "@flowboardlabs/mcp-server"],
      "env": {
        "FLOWBOARD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windows (REQUIRED — npx needs cmd wrapper):

{
  "mcpServers": {
    "flowboard": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@flowboardlabs/mcp-server"],
      "env": {
        "FLOWBOARD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Important: On Windows, you must use the cmd /c wrapper. Using npx directly as the command will fail silently.

Where to put this config

• Claude Code: .mcp.json in your project root
• Cursor: Cursor MCP settings
• Other tools: Check your tool's MCP configuration docs

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | FLOWBOARD_API_KEY | Yes | Your FlowBoard API key | | FLOWBOARD_API_URL | No | Custom API URL (for self-hosted instances) |

Available Tools

| Tool | Description | |------|-------------| | list_projects | List all projects in your workspace | | search_tasks | Search and filter tasks by board, status, project, assignee, type, or tags | | get_task | Get a single task with its comments | | create_task | Create a new idea or bug | | update_task | Change status, add comment, link a PR, assign someone | | delete_task | Soft-delete (trash) a task | | list_ideas | List ideas with optional filtering | | vote_idea | Toggle a vote on an idea | | list_releases | List releases in the workspace | | get_release | Get a release with its associated tasks | | get_comments | Get comments for a task | | add_comment | Add a comment to a task |

Example Prompts

Once configured, just ask naturally:

• "Show me all open bugs in the backend project"
• "Create a bug: login page returns 500 when email contains a plus sign"
• "Move task abc123 to in_progress and assign it to me"
• "What are the latest releases?"
• "Add a comment to task xyz: Fixed in PR #42"

Requirements

• Node.js >= 18
• A FlowBoard workspace with an API key

License

MIT