delete-board
Remove a Miro board by its unique ID using the Miro MCP server. Deleted boards are moved to Trash (on paid plans) and can be restored via the UI within 90 days.
Instructions
Delete a Miro board by its ID. Deleted boards go to Trash (on paid plans) and can be restored via UI within 90 days after deletion.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | Unique identifier (ID) of the board that you want to delete |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Unique identifier (ID) of the board that you want to delete",
"type": "string"
}
},
"required": [
"boardId"
],
"type": "object"
}
Implementation Reference
- src/tools/deleteBoard.ts:12-28 (handler)The handler function that executes the delete-board tool logic: validates boardId, calls Miro API to delete the board, and returns success or error response.fn: async ({ boardId }) => { try { if (!boardId) { return ServerResponse.error("Board ID is required"); } await MiroClient.getApi().deleteBoard(boardId); return ServerResponse.text(JSON.stringify({ success: true, message: `Board ${boardId} has been successfully deleted.` }, null, 2)); } catch (error) { process.stderr.write(`Error deleting Miro board: ${error}\n`); return ServerResponse.error(error); } }
- src/tools/deleteBoard.ts:9-11 (schema)Zod input schema defining the required 'boardId' parameter for the delete-board tool.args: { boardId: z.string().describe("Unique identifier (ID) of the board that you want to delete") },
- src/index.ts:114-114 (registration)Registration of the deleteBoardTool in the ToolBootstrapper chain..register(deleteBoardTool)