> ## Documentation Index
> Fetch the complete documentation index at: https://www.mill.fyi/llms.txt
> Use this file to discover all available pages before exploring further.

# get_board

> Read a board with Mill MCP.

Read a board's settings.

## Workflow

```mermaid theme={"system"}
flowchart LR
  step0["Choose a board UUID"] --> step1
  step1["Read current settings"] --> step2
  step2["Keep its version for edits"]
```

## Access and behavior

A Read-only, Write or Administrator OAuth grant can call this tool within the user’s current team role. Tools are listed and callable only when the current grant and role permit them.

Use the UUID in API paths. The task prefix is a human-readable identifier component, not the board ID. Creator presentation and task counts are supplied by list\_boards.

## Arguments

| Argument | Required | Type or meaning |
| - | - | - |
| `boardId` | Yes | Board UUID, not its task prefix. |

> **Complete input schema**
>
> ```json theme={"system"}
> {
>   "type": "object",
>   "properties": {
>     "boardId": {
>       "type": "string",
>       "format": "uuid",
>       "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
>     }
>   },
>   "required": ["boardId"],
>   "additionalProperties": false
> }
> ```

## Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_board",
    "arguments": {
      "boardId": "11111111-1111-4111-8111-111111111111"
    }
  }
}
```

## Example result

Mill returns this object in `structuredContent` and normally a JSON text content block (large responses may shorten the text block). A tool failure sets `isError`; never treat an error as a completed mutation.

```json theme={"system"}
{
  "board": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspaceId": "55555555-5555-4555-8555-555555555555",
    "name": "Engineering",
    "prefix": "ENG",
    "description": "Track delivery and reliability.",
    "version": 1,
    "nextNumber": 2,
    "createdAt": "2027-01-18T09:30:00.000Z",
    "updatedAt": "2027-01-18T09:30:00.000Z",
    "createdByUserId": "66666666-6666-4666-8666-666666666666",
    "createdByName": "Alex Morgan",
    "createdByKind": "human",
    "lastActivityAt": "2027-01-18T09:30:00.000Z"
  }
}
```

## Related reference

[HTTP operation](https://www.mill.fyi/api-reference/get_api_boards_by_boardId.md) · [Connect an MCP client](https://www.mill.fyi/mcp-connections.md) · [Request conventions](https://www.mill.fyi/api-reference/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.