# @mauvable/flowboards-mcp

MCP server for [Flow Boards](https://kanban.plus/pages/flowboards) — exposes the full Flow Boards REST API as Claude tools.

## Installation

Add to your Claude / MCP-compatible AI tool config:

```json
{
  "mcpServers": {
    "flowboards": {
      "command": "npx",
      "args": ["-y", "@mauvable/flowboards-mcp"],
      "env": {
        "FLOW_BOARDS_URL": "https://<host>/rest/2/<org-id>",
        "FLOW_BOARDS_TOKEN": "<your-bearer-token>"
      }
    }
  }
}
```

## Configuration

| Variable | Description |
|----------|-------------|
| `FLOW_BOARDS_URL` | Full API base URL including org path, e.g. `https://n1.fb.mauvable.com/rest/2/<org-id>` |
| `FLOW_BOARDS_TOKEN` | Bearer token for authentication |

## Available Tools

### Tickets
- `create_ticket` — Create a ticket in a flow (accepts flow name, resolves IDs automatically)
- `get_ticket` — Get ticket details
- `list_tickets` — List tickets by bin, parent, or child
- `update_ticket` — Update ticket fields
- `move_ticket` — Move ticket to a different bin
- `delete_ticket` / `delete_tickets` — Delete one or many tickets
- `archive_tickets` / `restore_tickets` — Archive or restore tickets
- `link_to_parent` — Link stories to an epic
- `unlink_from_parent` — Remove parent relationship
- `list_ticket_moves` — Movement history for a ticket

### Flows
- `list_flows` — List all flows
- `get_flow` — Get flow details
- `list_flow_tickets` — List tickets in a flow
- `list_flow_moves` — Movement history for a flow

### Bins
- `list_bins` / `get_bin` — List or get bins
- `create_bin` / `update_bin` — Create or update bins

### Boards
- `list_boards` / `get_board`

### Comments
- `add_comment` — Add a comment to a ticket
- `list_comments` / `get_comment` — Read comments
- `update_comment` / `delete_comment`

### Other
- `list_ticket_types` — Available ticket types (User Story, Epic, etc.)
- `list_custom_fields`
- `list_users` / `get_user` / `invite_user`
- `list_user_groups`
- `search_tickets`
- `list_webhooks` / `create_webhook` / `delete_webhook` / `test_webhook`

## Example Usage

Once configured, just talk to Claude naturally:

> "Create 3 user stories in the Backlog flow"
> "Move all stories in 'In Progress' to 'Done' in the Dev flow"
> "Add a comment 'Ready for review' to ticket abc123"
> "Link stories X, Y, Z to epic E"

...or if you like a fully automated flow you can give Clause the instructions to move tickets when it has done it's job.

> 1. Create User Stories and Epics from the attached reqirements documetent and put them into the backlog.
> 2. Link the apropiate User Stories as child tickets to their Epics.
> 3. Create an implementation plan.
> 4. Execute the implementation plan.
> 5. Move the User Stories and their Epic from the next phase in teh implementation plan, into the Next bin.
> 6. When you you start developing the first user story move it into the Developing bin. Move its parent Epic into Developing too.
> 7. When a user Story is done, move it into the Done bin and commit it to git.
> 8. Epics move automatically to the Done bin when all their child tickets are done.
> 9. After each phase ask me if I wan tto continue.