create_board

Access and behavior

Write or Administrator OAuth consent and a member/administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Requires workspace-wide write access. Prefixes use 2–10 uppercase letters/digits with a leading letter; omission derives an available prefix from the name. Every board uses the same six fixed statuses.

Arguments

Argument	Required	Type or meaning
`name`	Yes	string
`prefix`	No	string
`description`	No	string
`idempotencyKey`	No	One logical mutation key, reused unchanged on retries. MCP forwards it as the REST Idempotency-Key header.

Complete input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "prefix": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9]{1,9}$"
    },
    "description": {
      "type": "string",
      "maxLength": 10000
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    }
  },
  "required": ["name"],
  "additionalProperties": false
}

Example call

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_board",
    "arguments": {
      "name": "Engineering",
      "prefix": "ENG",
      "description": "Track delivery and reliability.",
      "idempotencyKey": "engineering-board-create-001"
    }
  }
}

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.

{
  "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": 1,
    "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"
  }
}

Connect a client

MCP reference

API Reference

create_board

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference