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

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYes
titleNo
messageYes
item_urlNo

Tool Definition Quality

Score is being calculated. Check back soon.

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