Miro MCP

Instructions

Implementation Reference

• src/tools/updateFrameItem.ts:33-93 (handler)

  The asynchronous handler function that validates inputs, constructs a FrameUpdateRequest object, and calls the Miro API to update the frame item.

  fn: async ({ boardId, itemId, data, position, geometry, style }: {
    boardId: string,
    itemId: string,
    data?: {
      title?: string,
      format?: string,
      type?: string,
      showContent?: boolean
    },
    position?: {
      x: number,
      y: number
    },
    geometry?: {
      width?: number,
      height?: number
    },
    style?: {
      fillColor?: string
    }
  }) => {
    try {
      if (!boardId) {
        return ServerResponse.error("Board ID is required");
      }
  
      if (!itemId) {
        return ServerResponse.error("Item ID is required");
      }
  
      const updateRequest = new FrameUpdateRequest();
      
      if (data) {
        const frameData = new FrameChanges();
        
        if (data.title !== undefined) frameData.title = data.title;
        if (data.format !== undefined) frameData.format = data.format;
        if (data.type !== undefined) frameData.type = data.type;
        if (data.showContent !== undefined) frameData.showContent = data.showContent;
        
        updateRequest.data = frameData;
      }
      
      if (position) {
        updateRequest.position = position;
      }
      
      if (geometry) {
        updateRequest.geometry = geometry;
      }
      
      if (style) {
        updateRequest.style = style;
      }
  
      const result = await MiroClient.getApi().updateFrameItem(boardId, itemId, updateRequest);
      return ServerResponse.text(JSON.stringify(result, null, 2));
    } catch (error) {
      return ServerResponse.error(error);
    }
  }

• src/tools/updateFrameItem.ts:9-32 (schema)

  ToolSchema definition including name, description, and Zod input schema for parameters.

  const updateFrameItemTool: ToolSchema = {
    name: "update-frame-item",
    description: "Update a frame on a Miro board based on the data, style, or geometry properties provided in the request body",
    args: {
      boardId: z.string().describe("Unique identifier (ID) of the board where you want to update the frame"),
      itemId: z.string().describe("Unique identifier (ID) of the frame that you want to update"),
      data: z.object({
        title: z.string().optional().nullish().describe("Title of the frame. This title appears at the top of the frame."),
        format: z.string().optional().nullish().describe("Format of the frame. Only 'custom' is supported currently."),
        type: z.string().optional().nullish().describe("Type of the frame. Only 'freeform' is supported currently."),
        showContent: z.boolean().optional().nullish().describe("Hide or reveal the content inside a frame (Enterprise plan only).")
      }).optional().nullish().describe("The updated content and configuration of the frame"),
      position: z.object({
        x: z.number().describe("X coordinate of the frame"),
        y: z.number().describe("Y coordinate of the frame")
      }).optional().nullish().describe("Updated position of the frame on the board"),
      geometry: z.object({
        width: z.number().optional().nullish().describe("Width of the frame"),
        height: z.number().optional().nullish().describe("Height of the frame")
      }).optional().nullish().describe("Updated dimensions of the frame"),
      style: z.object({
        fillColor: z.string().optional().nullish().describe("Fill color for the frame. Hex values like #f5f6f8, #d5f692, etc.")
      }).optional().nullish().describe("Updated style configuration of the frame")
    },

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

  Registration of the updateFrameItemTool in the ToolBootstrapper.

  .register(updateFrameItemTool)