Skip to main content
Glama

miro_update_image_from_file

Replace an existing image on a Miro board with a new local file while optionally updating its title, position, or parent frame.

Instructions

Replace the file on an existing image item with a new local image file.

USE WHEN: User says "replace this image", "swap the screenshot", "update the image file". Use this to change the file on an existing image item without creating a new one. For updating metadata only (title, position), use miro_update_image instead.

PARAMETERS:

  • board_id: Required

  • item_id: Required. The existing image item to update.

  • file_path: Absolute path to the new image file (required). Supports: png, jpg, jpeg, gif, webp, svg.

  • title: New image title/alt text

  • x, y: New position

  • parent_id: Frame ID to move image into

NOTE: The item must already exist as an image. The file must exist on the local filesystem.

RELATED: To create a new image from file, use miro_upload_image. To update metadata only, use miro_update_image.

VOICE-FRIENDLY: "Replaced image file on item"

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
board_idYesBoard ID
item_idYesImage item ID to update
file_pathYesAbsolute path to the new image file on disk
titleNoNew image title/alt text
xNoNew X position
yNoNew Y position
parent_idNoFrame ID to move image into
Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/olgasafonova/miro-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server