Miro

​

Overview

Visual workspace for innovation that enables distributed teams to collaborate. Through Langdock’s integration, you can access and manage Miro directly from your conversations.

​

Available Actions

​

Get Boards

miro.getBoards

Retrieves a list of boards accessible to the user Requires Confirmation: No Parameters:

• teamId (TEXT, Optional): Optional team ID to filter boards

Output: Returns array of boards with their IDs, names, descriptions, and other details

---

​

Search Boards

miro.searchBoards

Search for boards by name or description Requires Confirmation: No Parameters:

• query (TEXT, Required): Search term to find boards
  • teamId (TEXT, Optional): Optional team ID to filter search results
  • limit (NUMBER, Optional): Maximum number of boards to return (default: 10)

Output: Returns array of boards matching the search criteria

---

​

Get Recent Boards

miro.getRecentBoards

Get recently modified boards, sorted by modification date Requires Confirmation: No Parameters:

• limit (NUMBER, Optional): Maximum number of boards to return (default: 10)
  • teamId (TEXT, Optional): Optional team ID to filter boards

Output: Returns array of recently modified boards

---

​

Get Board Details

miro.getBoardDetails

Retrieves detailed information about a specific board Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The unique identifier of the board

Output: Returns board details including ID, name, description, and other properties

---

​

Get Board Items

miro.getBoardItems

Retrieves all items on a board with optional filtering by type Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The unique identifier of the board
  • itemType (TEXT, Optional): Filter by item type (e.g., sticky_note, text, shape, frame, card)

Output: Returns array of board items with their details

---

​

Get Frames

miro.getFrames

Retrieves all frames on a board Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The unique identifier of the board

Output: Returns array of frames with their details

---

​

Get Frame Items

miro.getFrameItems

Retrieves all items within a specific frame Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The unique identifier of the board
  • frameId (TEXT, Required): The unique identifier of the frame

Output: Returns array of items within the specified frame

---

​

Get Board Tags

miro.getBoardTags

Retrieves all tags used on a board for organization and categorization Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The unique identifier of the board

Output: Returns array of tags with their details

---

​

Get Specific Item

miro.getSpecificItem

Retrieves a specific item on a board by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the item
  • itemId (TEXT, Required): The ID of the specific item to retrieve

Output: Returns the specific item with its details

---

​

Get Frame

miro.getFrame

Retrieves a specific frame item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the frame
  • frameId (TEXT, Required): The ID of the frame to retrieve

Output: Returns the specific frame with its details

---

​

Get Card Item

miro.getCardItem

Retrieves a specific card item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the card
  • cardId (TEXT, Required): The ID of the card to retrieve

Output: Returns the specific card with its details

---

​

Get Document Item

miro.getDocumentItem

Retrieves a specific document item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the document
  • documentId (TEXT, Required): The ID of the document to retrieve

Output: Returns the specific document with its details

---

​

Get Embed Item

miro.getEmbedItem

Retrieves a specific embed item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the embed
  • itemId (TEXT, Required): The ID of the embed to retrieve

Output: Returns the specific embed with its details

---

​

Get Shape Item

miro.getShapeItem

Retrieves a specific shape item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the shape
  • itemId (TEXT, Required): The ID of the shape to retrieve

Output: Returns the specific shape with its details

---

​

Get Sticky Note Item

miro.getStickyNoteItem

Retrieves a specific sticky note item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the sticky note
  • itemId (TEXT, Required): The ID of the sticky note to retrieve

Output: Returns the specific sticky note with its details

---

​

Get Text Item

miro.getTextItem

Retrieves a specific text item by its ID Requires Confirmation: No Parameters:

• boardId (TEXT, Required): The ID of the board containing the text
  • itemId (TEXT, Required): The ID of the text item to retrieve

Output: Returns the specific text item with its details

---

​

Get Page Content

miro.getPageContent

Retrieves the content of a specific page or block and all its children from Notion and converts them to markdown Requires Confirmation: No Parameters:

• blockId (TEXT, Required): The unique identifier of the Notion page or block whose content you want to retrieve, including all its nested children blocks and their formatted content

Output: Returns the page content converted to markdown format

---

​

Query Database

miro.queryDatabase

Returns pages from a database with optional filters, sorts, and pagination. Use this action whenever you want to fetch multiple pages from a database Requires Confirmation: No Parameters:

• databaseId (TEXT, Required): ID or URL of the database to query
  • filter (TEXT, Optional): Notion filter object JSON. Supports ‘and’/‘or’ compound filters and all type-specific conditions
  • sorts (OBJECT, Optional): Array of Notion sort objects. Example: [property’:‘Last ordered’,‘direction’:‘ascending]
  • pageSize (NUMBER, Optional): Number of results per page (max 100). Defaults to 30
  • startCursor (TEXT, Optional): Cursor from a previous response for pagination
  • filterProperties (TEXT, Optional): Comma-separated property IDs to include in the response
  • returnAll (BOOLEAN, Optional): If true, paginates until all results are collected
  • simplifyOutput (BOOLEAN, Optional): Return simplified pages with id, url, title and flattened properties

Output: Returns array of database pages with their properties and content

---

​

Create Database

miro.createDatabase

Creates a database as a subpage in the specified parent page, with the specified properties schema. Requires parent page to be an actual page or Wiki Requires Confirmation: Yes Parameters:

• parentId (TEXT, Required): ID or URL of the parent PAGE (or wiki) under which the database will be created
  • title (TEXT, Optional): Optional database title
  • properties (OBJECT, Required): Property schema object. Example: Name’: title’: }, ‘Status’: status’: }, ‘Price’: number’: format’: ‘dollar}}
  • icon (TEXT, Optional): Emoji or full icon object
  • cover (TEXT, Optional): External cover URL or full external file object
  • isInline (BOOLEAN, Optional): Create the database inline on the page

Output: Returns the created database with ID, title, and properties schema

---

​

Update Database

miro.updateDatabase

Updates database metadata (title, description, icon, cover) and/or modifies database properties (add, remove, rename, or change schema) Requires Confirmation: Yes Parameters:

• databaseId (TEXT, Required): ID or URL of the database to update
  • title (TEXT, Optional): Optional new database title
  • description (TEXT, Optional): Optional new database description
  • properties (OBJECT, Optional): JSON object describing property changes. Use null to remove a property, provide { name: 'New name' } to rename, or pass a property schema object to change type/options
  • icon (TEXT, Optional): Emoji or full icon object
  • cover (TEXT, Optional): External cover URL or full external file object

Output: Returns the updated database with new metadata and properties

---

​

Get Page Details

miro.getPageDetails

Retrieves detailed information about a specific Notion page including its properties, metadata, and structure Requires Confirmation: No Parameters:

• pageId (TEXT, Required): The unique identifier of the Notion page you want to retrieve information about

Output: Returns page details including ID, title, properties, and metadata

---

​

Find Pages

miro.findPages

Searches for pages in your Notion workspace by title Requires Confirmation: No Parameters:

• query (TEXT, Optional): Search term used to find pages by their titles

Output: Returns array of pages matching the search criteria

---

​

Find Databases

miro.findDatabases

Searches for databases in your Notion workspace by title Requires Confirmation: No Parameters:

• query (TEXT, Optional): Search term used to find databases by their titles

Output: Returns array of databases matching the search criteria

---

​

Get Database Details

miro.getDatabaseDetails

Retrieves detailed information about a specific Notion database including its properties, metadata, and structure Requires Confirmation: No Parameters:

• databaseId (TEXT, Required): The unique identifier of the Notion database you want to retrieve information about

Output: Returns database details including ID, title, properties schema, and metadata

---

​

Search

miro.search

Searches across your entire Notion workspace or within a specific database for pages and content Requires Confirmation: No Parameters:

• query (TEXT, Optional): Search term to find pages or databases. Searches are case-insensitive and match partial words
  • databaseId (TEXT, Optional): Optional: Search within a specific database instead of the entire workspace
  • objectType (SELECT, Optional): Filter results by type. Choose ‘page’ for pages only or ‘database’ for databases only
  • propertyFilters (TEXT, Optional): Filter database pages by property values (requires database ID). Provide as JSON object
  • pageSize (NUMBER, Optional): Number of results to return per page. Default is 30, maximum is 100
  • sortBy (SELECT, Optional): Sort results by creation time or last edited time
  • sortDirection (SELECT, Optional): Sort order for results
  • createdBy (TEXT, Optional): Filter results by the user who created the page or database
  • lastEditedBy (TEXT, Optional): Filter results by the user who last edited the page or database
  • startCursor (TEXT, Optional): Pagination cursor from previous search results

Output: Returns array of pages and databases matching the search criteria

---

​

Create Page

miro.createPage

Creates a new page in Notion, either as a database entry or as a child of another page Requires Confirmation: Yes Parameters:

• parentId (TEXT, Required): The ID of the parent database or page where the new page will be created
  • parentType (SELECT, Optional): Type of parent where the page will be created
  • title (TEXT, Optional): The title of the new page
  • properties (OBJECT, Optional): Properties for the new page as a JSON object
  • content (TEXT, Optional): The content of the page. Can be plain text (will be converted to paragraphs) or an array of Notion blocks
  • icon (TEXT, Optional): An emoji or URL for the page icon
  • cover (TEXT, Optional): URL of an image to use as the page cover
  • createInPersonalRoot (BOOLEAN, Optional): When enabled and parentId is ‘workspace’ or ‘root’, creates the page at your personal workspace root

Output: Returns the created page with ID, title, and properties

---

​

Update Page

miro.updatePage

Updates a page’s properties and/or a specific block on that page. Use page fields for database/page metadata; use block fields to edit the content of an individual block Requires Confirmation: Yes Parameters:

• pageId (TEXT, Optional): ID of the page to update (properties, icon, cover, trash)
  • properties (TEXT, Optional): JSON object of properties to update
  • icon (TEXT, Optional): Emoji character or full Notion icon object
  • cover (TEXT, Optional): URL string or full Notion external file object
  • inTrash (BOOLEAN, Optional): Set true to move the page to trash, false to restore
  • blockId (TEXT, Optional): ID of the block to update (content editing)
  • blockType (TEXT, Optional): Block type to update (e.g., ‘paragraph’, ‘heading_1’, ‘heading_2’, ‘heading_3’, ‘to_do’, ‘bulleted_list_item’, ‘numbered_list_item’)
  • blockText (TEXT, Optional): Text content for the block (converted to rich_text)
  • blockChecked (BOOLEAN, Optional): Only for to_do blocks. true/false
  • blockPayload (TEXT, Optional): Advanced: full JSON body for the block update (overrides blockType/blockText)
  • blockArchived (BOOLEAN, Optional): Set true to archive the block, false to unarchive

Output: Returns the updated page or block with new values

​

Triggers

---

​

Updated Page

miro.updatedPage

Triggers when pages are updated Requires Confirmation: No Parameters:

• pageId (TEXT, Optional): ID of the page to monitor for updates

Output: Returns the result of the operation

---

​

Updated Database Item

miro.updatedDatabaseItem

Triggers when items in the database are updated Requires Confirmation: No Parameters:

• databaseId (TEXT, Required): ID of the database to monitor for updated items

Output: Returns the result of the operation

---

​

New Database Item

miro.newDatabaseItem

Triggers when new database items are added Requires Confirmation: No Parameters:

• databaseId (TEXT, Required): ID of the database to monitor for new items

Output: Returns the result of the operation

---

​

Common Use Cases

​

Best Practices

​

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

​

Support

For additional help with the Miro integration, contact support@langdock.com