create_board
Create a new Kanban board with custom columns to organize tasks and workflows in Yokan Board MCP.
Instructions
Creates a new Kanban board with an optional list of initial column names.
Args: name (str): The name of the new board. auth (AuthContext): The authentication context containing user ID and token. columns (List[str], optional): A list of names for initial columns. Defaults to an empty list.
Returns: int: The ID of the newly created board.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| auth | Yes | ||
| columns | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/main.py:123-148 (handler)The handler implementation for the 'create_board' tool, registered using @app_instance.tool and @error_handler.
async def create_board( name: str, auth: AuthContext, columns: List[str] = [], ) -> int: """Creates a new Kanban board with an optional list of initial column names. Args: name (str): The name of the new board. auth (AuthContext): The authentication context containing user ID and token. columns (List[str], optional): A list of names for initial columns. Defaults to an empty list. Returns: int: The ID of the newly created board. """ data = ( { "columns": {col: {"id": col, "title": col, "tasks": []} for col in columns}, "columnOrder": columns, } if columns else {} ) return await yokan_client.create_board( user_id=auth.user_id, name=name, data=data, token=auth.token )