Miro MCP

Instructions

Implementation Reference

• src/tools/deleteDocumentItem.ts:13-28 (handler)

  The handler function that executes the tool logic: validates boardId and itemId, calls MiroClient API to delete the document item, and returns success or error response.

  fn: async ({ boardId, itemId }) => {
    try {
      if (!boardId) {
        return ServerResponse.error("Board ID is required");
      }
      
      if (!itemId) {
        return ServerResponse.error("Item ID is required");
      }
  
      await MiroClient.getApi().deleteDocumentItem(boardId, itemId);
      return ServerResponse.text(JSON.stringify({ success: true, message: "Document item successfully deleted" }));
    } catch (error) {
      return ServerResponse.error(error);
    }
  }

• src/tools/deleteDocumentItem.ts:6-12 (schema)

  ToolSchema definition including the tool name, description, and Zod input schema for parameters boardId and itemId.

  const deleteDocumentItemTool: ToolSchema = {
    name: "delete-document-item",
    description: "Delete a specific document item from a Miro board",
    args: {
      boardId: z.string().describe("Unique identifier (ID) of the board that contains the document"),
      itemId: z.string().describe("Unique identifier (ID) of the document that you want to delete")
    },

• src/index.ts:145-145 (registration)

  Registration of the deleteDocumentItemTool in the ToolBootstrapper instance.

  .register(deleteDocumentItemTool)

• src/index.ts:44-44 (registration)

  Import of the deleteDocumentItemTool for registration.

  import deleteDocumentItemTool from './tools/deleteDocumentItem.js';