create-board
Create a new Miro board with custom name, description, sharing permissions, and team assignment.
Instructions
Create a new Miro board with specified name and sharing policies
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the board to create | |
| description | No | Description of the board | |
| sharingPolicy | No | Sharing policy for the board | |
| teamId | No | Team ID to assign the board to |
Implementation Reference
- src/tools/createBoard.ts:15-37 (handler)The asynchronous handler function that executes the core logic of the 'create-board' tool. It validates the board name, constructs board changes including sharing policy, calls MiroClient.getApi().createBoard(), and returns the board data or an error response.
fn: async ({ name, description, sharingPolicy, teamId }) => { try { if (!name) { return ServerResponse.error("Board name is required"); } const boardChanges = { name, description, sharingPolicy: { access: sharingPolicy || 'private' }, teamId }; const boardData = await MiroClient.getApi().createBoard(boardChanges); return ServerResponse.text(JSON.stringify(boardData, null, 2)); } catch (error) { process.stderr.write(`Error creating Miro board: ${error}\n`); return ServerResponse.error(error); } } - src/tools/createBoard.ts:6-14 (schema)The ToolSchema definition including the tool name, description, and Zod-based input schema for parameters: name (required string), description (optional), sharingPolicy (optional enum), teamId (optional).
const createBoardTool: ToolSchema = { name: "create-board", description: "Create a new Miro board with specified name and sharing policies", args: { name: z.string().describe("Name of the board to create"), description: z.string().optional().nullish().describe("Description of the board"), sharingPolicy: z.enum(['private', 'view', 'comment', 'edit']).optional().nullish().describe("Sharing policy for the board"), teamId: z.string().optional().nullish().describe("Team ID to assign the board to") }, - src/index.ts:112-112 (registration)Registers the createBoardTool with the ToolBootstrapper instance in the main server entry point.
.register(createBoardTool)