delete-shape-item

Remove a specific shape from a Miro board by providing the board ID and shape ID to clean up visual elements.

Instructions

Delete a specific shape item from a Miro board

Input Schema

TableJSON Schema

Name	Required	Description	Default
`boardId`	Yes	Unique identifier (ID) of the board that contains the shape
`itemId`	Yes	Unique identifier (ID) of the shape that you want to delete

Implementation Reference

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

The main handler function for the 'delete-shape-item' tool. It validates the boardId and itemId inputs, calls the MiroClient API to delete the shape item, and returns a 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().deleteShapeItem(boardId, itemId);
    return ServerResponse.text(JSON.stringify({ success: true, message: "Shape deleted successfully" }, null, 2));
  } catch (error) {
    return ServerResponse.error(error);
  }
}

src/tools/deleteShapeItem.ts:9-12 (schema)

Zod schema defining the input parameters for the tool: boardId (string) and itemId (string).

args: {
  boardId: z.string().describe("Unique identifier (ID) of the board that contains the shape"),
  itemId: z.string().describe("Unique identifier (ID) of the shape that you want to delete")
},

src/index.ts:160-160 (registration)
Registers the deleteShapeItemTool with the ToolBootstrapper instance, making the tool available in the MCP server.
```
.register(deleteShapeItemTool)
```
src/index.ts:60-60 (registration)
Imports the deleteShapeItemTool definition from its module for use in registration.
```
import deleteShapeItemTool from './tools/deleteShapeItem.js';
```

Tool Definition Quality

Score is being calculated. Check back soon.

Install Server

Miro MCP