com.mcparmory/miro
PYPI · MCPARMORY-MIRO · 2 COMPONENTS · SCANNED SEP 20
Create and manage collaborative boards, items, and diagrams programmatically
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Install-script risk not yet assessed.Unverified
- 2 of 46 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (MIT License) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 130 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability72
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 26826 tokens (~152/item across 176 items; 176 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 32 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 176 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the com.mcparmory/miro MCP server?
com.mcparmory/miro runs locally as a PyPI package, launched with uvx mcparmory-miro. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mcparmory-miro
claude mcp add com-mcparmory-miro -- uvx mcparmory-miro
{
"mcpServers": {
"com-mcparmory-miro": {
"command": "uvx",
"args": [
"mcparmory-miro"
]
}
}
} {
"servers": {
"com-mcparmory-miro": {
"command": "uvx",
"args": [
"mcparmory-miro"
]
}
}
} codex mcp add com-mcparmory-miro -- uvx mcparmory-miro
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-mcparmory-miro": {
"type": "local",
"command": [
"uvx",
"mcparmory-miro"
],
"enabled": true
}
}
} openclaw mcp add com-mcparmory-miro --command uvx --arg mcparmory-miro
mcp_servers:
com-mcparmory-miro:
command: "uvx"
args: ["mcparmory-miro"] {
"McpServers": {
"com-mcparmory-miro": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mcparmory-miro"
]
}
}
} assistant mcp add com-mcparmory-miro -t stdio -c uvx -a mcparmory-miro
{
"mcpServers": {
"com-mcparmory-miro": {
"command": "uvx",
"args": [
"mcparmory-miro"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Sept 26 −2
- Stability: pass → 0.83 functional
- 18 Sept 26 0
- Stability: 0.97 → pass security
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 14 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 −3
- Stability: pass → 0.77 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/mcparmory-miro@1.0.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Dependencies 46 packages
| Packages resolved | 46 |
|---|---|
| Stale | 1 |
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
add_document_to_board Add Document to Board ~118
Adds a document item to a board by hosting it at a specified URL. The document will be displayed on the board with an optional title for identification.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the document item will be created. |
| title | string | – | A short text label to identify the document on the board. If not provided, the document will be added without a custom title. |
| url | string | yes | The complete URL where the document is hosted and publicly accessible. Supports standard document formats like PDF. |
No output schema declared.
No examples provided.
add_embed_item_to_board Add Embed Item to Board ~220
Embeds external content on a board by creating an embed item. The content can be displayed inline on the board or in a modal overlay, with optional custom preview image and dimensions.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the embed item will be created. |
| height | number | – | The vertical size of the embed item in pixels. If not specified, a default height will be applied. |
| mode | string | – | Controls how the embedded content appears: 'inline' displays it directly on the board, while 'modal' shows it in an overlay. Defaults to inline if not specified. |
| previewUrl | string | – | URL of an image to display as the preview thumbnail for the embed item on the board. |
| url | string | yes | A valid URL (HTTP or HTTPS) pointing to the external content resource to embed. This is the actual content that will be displayed. |
| width | number | – | The horizontal size of the embed item in pixels. If not specified, a default width will be applied. |
No output schema declared.
No examples provided.
add_frame_to_board Add Frame to Board ~205
Adds a new frame to a board. Frames serve as containers for organizing and grouping content on a board, with customizable appearance and dimensions.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the frame will be created. |
| fillColor | string | – | The background fill color for the frame, specified as a hexadecimal color code. Supports a predefined palette of colors or transparent (default). |
| format | string | – | The frame format type. Currently, only custom frames are supported. |
| height | number | – | The height of the frame in pixels. |
| showContent | boolean | – | Whether to show or hide the content inside the frame. This feature is available only on Enterprise plans. |
| title | string | – | The title displayed at the top of the frame. |
| type | string | – | The frame layout type. Currently, only freeform frames are supported, allowing flexible content arrangement. |
| width | number | – | The width of the frame in pixels. |
No output schema declared.
No examples provided.
add_image_to_board Add Image to Board ~176
Adds an image item to a board by URL. Optionally customize the image with a title, dimensions, and rotation angle.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the image will be added. |
| height | number | – | The height of the image in pixels. If not specified, the image's original height is used. |
| rotation | number | – | The rotation angle in degrees. Use positive values to rotate clockwise and negative values to rotate counterclockwise. |
| title | string | – | A short text label to identify the image on the board. |
| url | string | yes | The URL of the image to add. Must be a valid, publicly accessible image URL. |
| width | number | – | The width of the image in pixels. If not specified, the image's original width is used. |
No output schema declared.
No examples provided.
add_member_to_group Add Member to Group ~119
Adds a user to a group within an organization. This enterprise-only operation requires Company Admin role and the organizations:groups:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | The email address of the user to add to the group. Must be a valid email format associated with an existing user in the organization. | |
| group_id | string | yes | The unique identifier of the user group to which the member will be added. |
| org_id | string | yes | The unique identifier of the organization containing the group. Use the organization ID provided in your enterprise account. |
No output schema declared.
No examples provided.
add_project_member Add Project Member ~150
Add a Miro user to a project (Space) with a specified role. This enterprise-only operation requires Company Admin privileges and the projects:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | The email address of the Miro user to add to the project. | |
| org_id | string | yes | The unique identifier of the organization that owns the project. |
| project_id | string | yes | The unique identifier of the project (Space) to which you want to add the user. |
| role | string | yes | The access level for the project member. Choose from: owner, coowner, editor, commentator, or viewer. |
| team_id | string | yes | The unique identifier of the team that owns the project. |
No output schema declared.
No examples provided.
add_shape_to_board Add Shape to Board ~557
Adds a shape item to a board with customizable geometry, styling, and text formatting. Requires boards:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the shape will be created. |
| borderColor | string | – | Hex color code for the shape border. Defaults to dark gray (#1a1a1a). |
| borderOpacity | string | – | Opacity of the border as a decimal between 0 (fully transparent) and 1 (fully opaque). Defaults to 1.0. |
| borderStyle | string | – | Visual style of the border: normal (solid), dotted, or dashed. Defaults to normal. |
| borderWidth | string | – | Border thickness in display pixels, ranging from 1 to 24. Defaults to 2.0. |
| color | string | – | Hex color code for the text content. Defaults to dark gray (#1a1a1a). |
| content | string | – | Optional text content to display on the shape. Not supported for flow_chart_or and flow_chart_summing_junction shapes. |
| fillColor | string | – | Hex color code for the shape fill. Accepts predefined palette colors or custom hex values. Defaults to white (#ffffff). |
| fillOpacity | string | – | Opacity of the fill color as a decimal between 0 (fully transparent) and 1 (fully opaque). Defaults to 1.0 for flowchart shapes, or 1.0 if fillColor is specified for basic shapes, otherwise 0.0. |
| fontFamily | string | – | Font family for text rendering. Choose from standard fonts (Arial, Georgia, Times New Roman) or decorative options (Bangers, Permanent Marker, etc.). Defaults to Arial. |
| fontSize | string | – | Font size for text in display pixels, ranging from 10 to 288. Defaults to 14. |
| height | number | – | Height of the shape in pixels. |
| rotation | number | – | Rotation angle in degrees relative to the board. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| shape | string | – | The geometric shape type to render. Choose from basic shapes (rectangle, circle, triangle, etc.), flowchart shapes (decision, process, terminator, etc.), or arrow/callout variants. Defaults to rectan… |
| textAlign | string | – | Horizontal text alignment: left, right, or center. Defaults to center for flowchart shapes, left for basic shapes. |
| textAlignVertical | string | – | Vertical text alignment: top, middle, or bottom. Defaults to middle for flowchart shapes, top for basic shapes. |
| width | number | – | Width of the shape in pixels. |
No output schema declared.
No examples provided.
add_shape_to_board_flowchart Add Shape to Board Flowchart ~560
Adds a flowchart or basic shape item to a board with customizable styling, text, and dimensions. Requires boards:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the shape will be created. |
| borderColor | string | – | Hex color code for the shape's border. Defaults to dark gray (#1a1a1a). |
| borderOpacity | string | – | Transparency level of the border, from 0 (fully transparent) to 1 (fully opaque). Defaults to 1. |
| borderStyle | string | – | Visual style of the border: solid (normal), dotted, or dashed. Defaults to normal. |
| borderWidth | string | – | Thickness of the border in display pixels, ranging from 1 to 24. Defaults to 2. |
| color | string | – | Hex color code for the text inside the shape. Defaults to dark gray (#1a1a1a). |
| content | string | – | Optional text to display on the shape. Not supported for OR gates and summing junction flowchart shapes. |
| fillColor | string | – | Hex color code for the shape's fill. Supports predefined colors like #8fd14f, #f5d128, #ff9d48, and others. Defaults to white (#ffffff). |
| fillOpacity | string | – | Transparency level of the fill color, from 0 (fully transparent) to 1 (fully opaque). Flowchart shapes default to 1; basic shapes default to 1 if fillColor is set, otherwise 0. |
| fontFamily | string | – | Font family for the shape's text. Choose from standard fonts (Arial, Georgia, Times New Roman) or decorative options (Bangers, Permanent Marker, etc.). Defaults to Arial. |
| fontSize | string | – | Font size for the text in display pixels, ranging from 10 to 288. Defaults to 14. |
| height | number | – | Height of the shape in pixels. |
| rotation | number | – | Rotation angle in degrees. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| shape | string | – | The geometric shape type to render. Choose from basic shapes (rectangle, circle, triangle, etc.), flowchart shapes (decision, process, terminator, etc.), or arrows. Defaults to rectangle. |
| textAlign | string | – | Horizontal text alignment: left, right, or center. Flowchart shapes default to center; basic shapes default to left. |
| textAlignVertical | string | – | Vertical text alignment: top, middle, or bottom. Flowchart shapes default to middle; basic shapes default to top. |
| width | number | – | Width of the shape in pixels. |
No output schema declared.
No examples provided.
add_sticky_note Add Sticky Note ~249
Adds a sticky note item to a board with customizable text content, shape, colors, and alignment. Requires boards:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the sticky note will be created. |
| content | string | – | The text content displayed in the sticky note (e.g., 'Hello'). |
| fillColor | string | – | The fill color of the sticky note. Choose from: gray, light_yellow, yellow, orange, light_green, green, dark_green, cyan, light_pink, pink, violet, red, light_blue, blue, dark_blue, or black. Default… |
| height | number | – | The height of the sticky note in pixels. |
| shape | string | – | The geometric shape of the sticky note: either square or rectangle. Defaults to square. |
| textAlign | string | – | Horizontal text alignment within the sticky note: left, right, or center. Defaults to center. |
| textAlignVertical | string | – | Vertical text alignment within the sticky note: top, middle, or bottom. Defaults to top. |
| width | number | – | The width of the sticky note in pixels. |
No output schema declared.
No examples provided.
add_tag_to_item Add Tag to Item ~124
Attach an existing tag to an item on a board. Cards and sticky notes support up to 8 tags each. Note: Tag changes via REST API require a board refresh to appear in real-time.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id_PlatformTags | string | yes | The unique identifier of the board containing the item you want to tag. |
| item_id | string | yes | The unique identifier of the item (card or sticky note) to which you want to attach the tag. |
| tag_id | string | yes | The unique identifier of the existing tag you want to attach to the item. |
No output schema declared.
No examples provided.
add_team_member Add Team Member ~156
Invite an existing Miro organization user to join a team. The user must already exist in your Miro organization; new users can be provisioned via SCIM and external identity providers like Okta or Azure Active Directory.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | The email address of the existing Miro organization user to invite to the team. | |
| org_id | string | yes | The unique identifier of the organization containing the team. |
| role | string | – | The role to assign to the team member. Use 'member' for standard team member permissions or 'admin' to grant team management capabilities. Defaults to 'member' if not specified. |
| team_id | string | yes | The unique identifier of the team to which the user will be invited. |
No output schema declared.
No examples provided.
add_text_to_board Add Text to Board ~314
Adds a text item to a board with customizable styling, positioning, and formatting options. Requires boards:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the text item will be created. |
| color | string | – | Hex color code for the text itself. Defaults to black (#1a1a1a). |
| content | string | yes | The text content to display in the item. |
| fillColor | string | – | Hex color code for the background fill of the text item. Defaults to white (#ffffff). |
| fillOpacity | string | – | Opacity of the background color, ranging from 0.0 (fully transparent) to 1.0 (fully opaque). Defaults to 1.0 if a fill color is specified, otherwise 0.0. |
| fontFamily | string | – | Font family for the text. Choose from a curated set of web-safe and decorative fonts. Defaults to Arial. |
| fontSize | string | – | Font size in display pixels. Must be at least 1 pixel. Defaults to 14 pixels. |
| rotation | number | – | Rotation angle in degrees. Positive values rotate clockwise, negative values rotate counterclockwise. |
| textAlign | string | – | Horizontal text alignment within the item: left, right, or center. Defaults to center. |
| width | number | – | Width of the item in pixels. Must be at least 1.7 times the font size (e.g., minimum 24 pixels for 14pt font). |
No output schema declared.
No examples provided.
add_user_group_to_team Add User Group to Team ~122
Adds a user group to a team within an organization, establishing the group's membership and role. This enterprise-only operation requires Company Admin privileges.
| Name | Type | Req | Description |
|---|---|---|---|
| org_id | string | yes | The unique identifier of the organization where the team resides. |
| role | string | yes | The role assigned to the user group within the team. Currently supports member role. |
| team_id | string | yes | The unique identifier of the team to which the user group will be added. |
| userGroupId | string | yes | The unique identifier of the user group to be added to the team. |
No output schema declared.
No examples provided.
cancel_board_export_job Cancel Board Export Job ~119
Cancel an ongoing board export job. This operation allows you to stop a board export job that is currently in progress by updating its status to CANCELLED.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | The unique identifier of the board export job to cancel. This must be a valid UUID format. |
| org_id | string | yes | The unique identifier of the organization that owns the export job. This is a numeric string identifier. |
| status | string | yes | The target status for the export job. Only CANCELLED is supported, which stops the ongoing export operation. |
No output schema declared.
No examples provided.
close_case Close Case ~89
Permanently close and delete a case, marking the conclusion of a legal matter or investigation. All associated legal holds must be closed before closing the case. Requires Enterprise Guard add-on with Company Admin and eDiscovery Admin roles.
| Name | Type | Req | Description |
|---|---|---|---|
| case_id | string | yes | The numeric ID of the case to close and delete. |
| org_id | string | yes | The numeric ID of the organization containing the case to close. |
No output schema declared.
No examples provided.
close_legal_hold Close Legal Hold ~109
Close and permanently delete a legal hold in a case, releasing preserved Miro boards and custodians back to normal operations. Note: content release may take up to 24 hours to complete.
| Name | Type | Req | Description |
|---|---|---|---|
| case_id | string | yes | The numeric ID of the case containing the legal hold to close. |
| legal_hold_id | string | yes | The numeric ID of the legal hold to close and permanently delete. |
| org_id | string | yes | The numeric ID of the organization containing the legal hold to close. |
No output schema declared.
No examples provided.
create_app_card Create App Card ~294
Adds a new app card item to a board. App cards display custom content with optional preview fields and can be styled with colors, dimensions, and rotation.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the app card will be created. |
| description | string | – | A short text description providing context about the app card's purpose or content. |
| fields | array | – | An array of custom preview field objects that will be displayed in the bottom half of the app card in compact view. Each field object defines a key-value pair for the preview. |
| fillColor | string | – | The hex color code for the app card's border. Defaults to '#2d9bf0' (blue). |
| height | number | – | The height of the app card in pixels. |
| rotation | number | – | The rotation angle of the app card in degrees relative to the board. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| status | string | – | The synchronization status of the app card with its source. Use 'disconnected' for new cards, 'connected' when synced with an active source, or 'disabled' if the source has been deleted. Defaults to… |
| title | string | – | A short text header identifying the app card. Defaults to 'sample app card item'. |
| width | number | – | The width of the app card in pixels. |
No output schema declared.
No examples provided.
create_board Create Board ~437
Creates a new board with a specified name, description, and access control policies. Configure sharing permissions, collaboration tool access, and team placement to control who can view, edit, and manage the board.
| Name | Type | Req | Description |
|---|---|---|---|
| access | string | – | Sets the public access level for the board. Defaults to private. Options include private (no public access), view-only, comment, or full edit access. |
| collaborationToolsStartAccess | string | – | Controls who can initiate or stop collaboration features like timers, voting, video chat, and screen sharing. Other users can only join these features. Defaults to allowing all editors. Contact Miro… |
| copyAccess | string | – | Determines who can copy the board, duplicate objects, export images, or save as template/PDF. Defaults to allowing anyone. Options range from open access to board owner only. |
| description | string | – | Optional description of the board's purpose or content. Limited to 300 characters. |
| inviteToAccountAndBoardLinkAccess | string | – | Specifies the default user role when inviting users via team and board links. Defaults to no access. Enterprise users are always set to no access regardless of this value. |
| name | string | – | Display name for the board. Defaults to 'Untitled' if not provided. Must be between 1 and 60 characters. |
| organizationAccess | string | – | Controls organization-level access to the board. Defaults to private. Only applies if the team belongs to an organization; otherwise defaults are used. |
| sharingAccess | string | – | Controls who can modify board access permissions and invite new users. Defaults to team members with editing rights. Contact Miro support to change this setting. |
| teamAccess | string | – | Sets team-level access to the board. Defaults to edit access on free plans and private on other plans. Options include private, view-only, comment, or edit access. |
| teamId | string | – | The unique identifier of the team where the board will be created. If not specified, the board is created in the default team. On Enterprise plans, board owners and admins can move boards between tea… |
No output schema declared.
No examples provided.
create_board_copy Create Board Copy ~492
Creates a duplicate of an existing board with optional customization of name, description, and access control policies. The new board can be placed in a specific team and configured with granular sharing and permission settings.
| Name | Type | Req | Description |
|---|---|---|---|
| access | string | – | Sets the public access level for the board: private (no public access), view (read-only), edit (collaborative), or comment (feedback only). Defaults to private. |
| collaborationToolsStartAccess | string | – | Controls who can initiate or stop collaboration features like timers, voting, video chat, and screen sharing. Other users can only join these features. Defaults to allowing all editors. Contact Miro… |
| copyAccess | string | – | Determines who can copy the board, duplicate objects, export images, or save as template/PDF. Options range from unrestricted (anyone) to board owner only. Defaults to anyone. |
| copy_from | string | yes | The unique identifier of the source board to duplicate. This board must exist and be accessible to the requesting user. |
| description | string | – | Optional text describing the new board's purpose or content. Limited to 300 characters maximum. |
| inviteToAccountAndBoardLinkAccess | string | – | Specifies the default user role when inviting via team and board link: viewer, commenter, editor, or no access. Enterprise users are always set to no access. Defaults to no access. |
| name | string | – | Display name for the new board. Must be between 1 and 60 characters. Defaults to 'Untitled' if not provided. |
| organizationAccess | string | – | Controls organization-level access to the board if it belongs to an organization. Options: private, view, comment, or edit. Defaults to private and is ignored for teams outside an organization. |
| sharingAccess | string | – | Controls who can modify board access settings and send invitations. Restricted to team members with editing rights or owner/co-owners only. Defaults to team members with editing rights. Contact Miro… |
| teamAccess | string | – | Sets team-level access permissions: private (restricted), view (read-only), comment (feedback), or edit (collaborative). Defaults to edit on free plans and private on paid plans. |
| teamId | string | – | The unique identifier of the team where the new board should be created. If omitted, the board is placed in the default team. |
No output schema declared.
No examples provided.
create_board_export_job Create Board Export Job ~169
Initiates an asynchronous export job for one or more boards in a specified format (SVG, HTML, or PDF). This enterprise-only operation requires Company Admin role and eDiscovery enablement.
| Name | Type | Req | Description |
|---|---|---|---|
| boardFormat | string | – | The output file format for the exported boards. Choose from SVG (default), HTML, or PDF. Defaults to SVG if not specified. |
| boardIds | array | – | List of board IDs to include in the export. Accepts 1 to 50 board IDs. If omitted, the behavior depends on your organization's default settings. |
| org_id | string | yes | The unique identifier of the organization that owns the boards to be exported. |
| request_id | string | yes | A unique identifier (UUID format) for this export job request, used to track and reference the job. |
No output schema declared.
No examples provided.
create_board_export_task_download_link Create Board Export Task Download Link ~150
Generate a downloadable link for the results of a specific board export task within an enterprise export job. This endpoint is available only to Enterprise plan users with Company Admin role and eDiscovery enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | The unique identifier of the board export job. This must be a valid UUID that corresponds to an existing export job. |
| org_id | string | yes | The unique identifier of the organization that owns the export job. This is a numeric ID specific to your enterprise account. |
| task_id | string | yes | The unique identifier of the specific task within the export job for which you want to create a download link. This must be a valid UUID that corresponds to an existing task. |
No output schema declared.
No examples provided.
create_card_item Create Card Item ~275
Creates a new card item on a specified board. Cards can include a title, description, due date, assignee, and visual styling to organize tasks and activities.
| Name | Type | Req | Description |
|---|---|---|---|
| assigneeId | string | – | The numeric user ID of the person assigned to own this card. User IDs are automatically assigned when users first sign up. |
| board_id | string | yes | The unique identifier of the board where the card will be created. |
| cardTheme | string | – | The hex color code for the card's border. Defaults to #2d9bf0 (blue) if not specified. |
| description | string | – | A short text description providing context or details about the card's content. |
| dueDate | string | – | The completion deadline for the task or activity, specified in UTC using ISO 8601 format with a trailing Z offset (e.g., 2023-10-12T22:00:55.000Z). |
| height | number | – | The height of the card in pixels. |
| rotation | number | – | The rotation angle of the card in degrees relative to the board. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| title | string | – | A short text header or title for the card. |
| width | number | – | The width of the card in pixels. |
No output schema declared.
No examples provided.
create_case Create Case ~113
Create a new legal hold case in your organization to initiate the eDiscovery process. Cases serve as containers for grouping multiple legal holds together during litigation or investigations. Requires Enterprise Guard add-on and eDiscovery Admin role.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Optional additional details or context about the case to help organize and document the legal hold. |
| name | string | yes | A descriptive name for the case that identifies the legal matter or investigation. |
| org_id | string | yes | The numeric ID of the organization where the case will be created. |
No output schema declared.
No examples provided.
create_connector Create Connector ~562
Creates a connector between two items on a board, with customizable styling, line shape, and optional text captions. Connectors can be attached to specific sides of items or automatically positioned.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the connector will be created. |
| captions | array | – | An array of text blocks to display on the connector, with a maximum of 20 captions. |
| color | string | – | The hex color code for the caption text. Defaults to '#1a1a1a' (dark gray). |
| endItemId | string | – | The unique identifier of the item where the connector ends. Frames are not supported. |
| endItemSnapTo | string | – | The side of the end item where the connector attaches (top, right, bottom, or left). Use 'auto' to automatically select the optimal connection point. Defaults to 'auto' if neither this nor position i… |
| endStrokeCap | string | – | The decoration style at the end of the connector line, such as arrows, circles, or ERD symbols. Defaults to 'stealth'. |
| fontSize | string | – | The font size for captions in density-independent pixels, ranging from 10 to 288. Defaults to 14. |
| shape | string | – | The visual path type of the connector line: 'straight' for direct lines, 'elbowed' for right-angle turns, or 'curved' for smooth curves. Defaults to 'curved'. |
| startItemId | string | – | The unique identifier of the item where the connector starts. Frames are not supported. |
| startItemSnapTo | string | – | The side of the start item where the connector attaches (top, right, bottom, or left). Use 'auto' to automatically select the optimal connection point. Defaults to 'auto' if neither this nor position… |
| startStrokeCap | string | – | The decoration style at the start of the connector line, such as arrows, circles, or ERD symbols. Defaults to 'none'. |
| strokeColor | string | – | The hex color code for the connector line. Defaults to '#000000' (black). |
| strokeStyle | string | – | The stroke pattern of the connector line: 'normal' for solid, 'dotted' for dots, or 'dashed' for dashes. Defaults to 'normal'. |
| strokeWidth | string | – | The thickness of the connector line in density-independent pixels, ranging from 1 to 24. Defaults to 1.0. |
| textOrientation | string | – | The orientation of captions relative to the connector line: 'horizontal' for fixed horizontal text or 'aligned' to follow the line's curvature. Defaults to 'aligned'. |
No output schema declared.
No examples provided.
create_document_item_from_file Create Document Item from File ~197
Uploads a document file from your device and adds it as a document item to a board. The file must not exceed 6 MB in size.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id_PlatformFileUpload | string | yes | The unique identifier of the board where the document item will be created. |
| height | number | – | Optional height of the document item on the board, specified in pixels. |
| resource | string | yes | Base64-encoded file content for upload. The file to upload from your device. Maximum file size is 6 MB. |
| rotation | number | – | Optional rotation angle of the document item in degrees, relative to the board. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| title | string | – | Optional title for the document item. If not provided, the uploaded filename will be used. |
| width | number | – | Optional width of the document item on the board, specified in pixels. |
No output schema declared.
No examples provided.
create_group_organization Create Group in Organization ~104
Creates a new user group within an organization. This enterprise-only operation requires Company Admin role and the organizations:groups:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | An optional description of the user group's purpose or membership. Can be up to 300 characters. |
| name | string | yes | The name of the user group. Must be between 1 and 60 characters. |
| org_id | string | yes | The unique identifier of the organization where the group will be created. |
No output schema declared.
No examples provided.
create_image_item_from_local_file Create Image Item from Local File ~231
Adds an image item to a board by uploading a file from your device. Supports images up to 6 MB with optional sizing, rotation, and accessibility metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| altText | string | – | Optional alt text describing the image content for accessibility purposes. |
| board_id_PlatformFileUpload | string | yes | The unique identifier of the board where the image item will be created. |
| height | number | – | Optional height of the image item in pixels. If not specified, the original image dimensions will be used. |
| resource | string | yes | Base64-encoded file content for upload. The image file to upload from your device. Maximum file size is 6 MB. |
| rotation | number | – | Optional rotation angle in degrees. Use positive values for clockwise rotation and negative values for counterclockwise rotation. |
| title | string | – | Optional display title for the image item (e.g., 'foo.png'). If not provided, the filename may be used. |
| width | number | – | Optional width of the image item in pixels. If not specified, the original image dimensions will be used. |
No output schema declared.
No examples provided.
create_items_bulk Create Items in Bulk ~124
Create multiple items of different types on a board in a single transactional operation. Supports up to 20 items per call (cards, shapes, sticky notes, etc.), and all items are created together or none are created if any item fails.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where items will be created. |
| body | array | yes | Array of item objects to create. Must contain between 1 and 20 items. Items can be of different types (cards, shapes, sticky notes, etc.) and are processed together as a single transaction. |
No output schema declared.
No examples provided.
create_legal_hold_for_case Create Legal Hold for Case ~192
Create a new legal hold within a case to preserve content owned, co-owned, created, edited, or accessed by specified users. Legal holds may take up to 24 hours to process.
| Name | Type | Req | Description |
|---|---|---|---|
| case_id | string | yes | The numeric ID of the case within the organization where the legal hold will be applied. |
| description | string | – | An optional detailed description providing additional context or information about the legal hold. |
| name | string | yes | A descriptive name for the legal hold to identify its purpose or scope. |
| org_id | string | yes | The numeric ID of the organization where the legal hold will be created. |
| scope | object | yes | The scope criteria for the legal hold, currently supporting only the 'users' variant. Specify a list of up to 200 users to place under hold; this list must include all users for new holds or updates,… |
No output schema declared.
No examples provided.
create_markdown_doc Create Markdown Document ~100
Creates a new markdown document item on a board. The document is formatted as markdown text and will be added to the specified board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the markdown document will be created. |
| content | string | yes | The markdown-formatted text content for the document. |
| contentType | string | yes | The format type for the document content. Must be set to 'markdown' to specify markdown formatting. |
No output schema declared.
No examples provided.
create_mindmap_node Create Mind Map Node ~136
Create a new mind map node on a board. Nodes can be root nodes (starting points) or child nodes nested under existing nodes. Node positioning uses explicit x, y coordinates; if not provided, nodes default to the board center (0, 0).
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the mind map node will be created. |
| content | string | – | The text content displayed in the mind map node. |
| type | string | yes | The type of mind map node. Currently only 'text' is supported. |
| width | number | – | The width of the node in pixels. |
No output schema declared.
No examples provided.
create_project_in_team Create Project in Team ~116
Create a new project (Space) within an existing team in your organization. Projects are organizational folders for boards that allow you to manage access and share multiple boards with a subset of team members.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The name for the new project. Must be between 1 and 60 characters. |
| org_id | string | yes | The unique identifier of the organization where you want to create the project. |
| team_id | string | yes | The unique identifier of the team within the organization where you want to create the project. |
No output schema declared.
No examples provided.
create_tag Create Tag ~146
Creates a new tag on a board to organize and categorize board items. Tag titles must be unique within the board and can be assigned a color for visual distinction.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board where the tag will be created. |
| fillColor | string | – | The visual color for the tag. Choose from a predefined palette of 12 colors including red, green, blue, cyan, yellow, magenta, violet, gray, black, and their variants. Defaults to red if not specifie… |
| title | string | yes | The display text for the tag, case-sensitive and must be unique within the board. Can be up to 120 characters long. |
No output schema declared.
No examples provided.
create_team Create Team ~78
Creates a new team within an existing organization. This enterprise-only operation requires Company Admin role and the organizations:teams:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The name for the new team. Must be between 1 and 60 characters long. |
| org_id | string | yes | The unique identifier of the organization where the team will be created. |
No output schema declared.
No examples provided.
create_user Create User ~580
Creates a new user in the organization and automatically adds them to the default team. The user's identity is established via email address provided in the userName field.
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean | – | Whether the user is active or deactivated in the organization. Defaults to active when not specified. |
| costCenter | string | – | The cost center associated with the user, up to 120 characters. |
| department | string | – | The department within the organization associated with the user, up to 120 characters. |
| displayName | string | – | A human-readable full name for the user, up to 60 characters. When provided, this takes precedence over constructed names from givenName and familyName. |
| division | string | – | The division within the organization associated with the user, up to 120 characters. |
| employeeNumber | string | – | An internal employee identifier for the user, up to 20 characters. |
| familyName | string | yes | The user's last name. Combined with givenName, the total character count cannot exceed 60 characters. Used to construct the user's full name if displayName is not provided. |
| givenName | string | yes | The user's first name. Combined with familyName, the total character count cannot exceed 60 characters. Used to construct the user's full name if displayName is not provided. |
| organization | string | – | The organization name or identifier associated with the user, up to 120 characters. |
| photos | array | – | An array of profile photos for the user. Each photo must be a publicly accessible URL (jpg, jpeg, bmp, png, or gif format) with a maximum file size of 31 MB. The URL must include the file extension o… |
| preferredLanguage | string | – | The user's preferred language in locale format (e.g., en_US for English). This setting controls the language used in the user's interface. |
| roles | array | – | An array of roles assigned to the user. Organization-level roles include ORGANIZATION_INTERNAL_ADMIN and ORGANIZATION_INTERNAL_USER. Admin roles include Content Admin, User Admin, Security Admin, or… |
| userName | string | yes | The unique email address that serves as the user's login identifier and username. This email becomes the user's full name if displayName or name attributes are not provided. |
| userType | string | – | The user's license type in the organization. Supported values include: Full, Free, Free Restricted, Full (Trial), and Basic. When not specified, the license is assigned automatically based on the org… |
| value | string | – | The manager's identifier as a numeric value. Non-numeric values are ignored. This field maps to Miro's internal managerId field which expects a Long type. |
No output schema declared.
No examples provided.
delete_app_card_item Delete App Card Item ~77
Removes an app card item from a specified board. Requires boards:write scope and is subject to Level 3 rate limiting.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the app card item to delete. |
| item_id | string | yes | The unique identifier of the app card item to delete from the board. |
No output schema declared.
No examples provided.
delete_board Delete Board ~69
Permanently delete a board, moving it to Trash on paid plans where it can be restored within 90 days. On free plans, deletion may be immediate.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board to delete. This is a required string that identifies which board will be removed. |
No output schema declared.
No examples provided.
delete_card_item Delete Card Item ~72
Permanently removes a card item from a board. This action cannot be undone and requires write access to the board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the card item to delete. |
| item_id | string | yes | The unique identifier of the card item to delete from the board. |
No output schema declared.
No examples provided.
delete_connector Delete Connector ~63
Removes a connector from a board. The connector is permanently deleted and cannot be recovered.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the connector to delete. |
| connector_id | string | yes | The unique identifier of the connector to delete from the board. |
No output schema declared.
No examples provided.
delete_doc_format_item Delete Doc Format Item ~74
Permanently removes a doc format item from a board. This action cannot be undone and requires write access to the board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the item to delete. |
| item_id | string | yes | The unique identifier of the doc format item to delete from the board. |
No output schema declared.
No examples provided.
delete_document_item Delete Document Item ~72
Permanently removes a document item from a board. This action cannot be undone and requires write access to the board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the document item to delete. |
| item_id | string | yes | The unique identifier of the document item to delete from the board. |
No output schema declared.
No examples provided.
delete_embed_item Delete Embed Item ~68
Removes an embed item from a board. The embed item is permanently deleted and cannot be recovered.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the embed item to delete. |
| item_id | string | yes | The unique identifier of the embed item to delete from the board. |
No output schema declared.
No examples provided.
delete_frame Delete Frame ~69
Permanently removes a frame from a board. The frame and all its contents will be deleted and cannot be recovered.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the frame to delete. |
| item_id | string | yes | The unique identifier of the frame to delete from the board. |
No output schema declared.
No examples provided.
delete_group Delete Group ~100
Permanently deletes a group from a board, including all items contained within it. Note that this operation will delete locked items as well.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the group to delete. |
| delete_items | boolean | yes | Set to true to remove all items in the group along with the group itself. Set to false to preserve items. |
| group_id | string | yes | The unique identifier of the group to delete. |
No output schema declared.
No examples provided.
delete_group_organization Delete Group from Organization ~69
Permanently removes a user group from an organization. This operation is restricted to Enterprise plan users with Company Admin role.
| Name | Type | Req | Description |
|---|---|---|---|
| group_id | string | yes | The unique identifier of the user group to delete. |
| org_id | string | yes | The unique identifier of the organization containing the group to delete. |
No output schema declared.
No examples provided.
delete_image_item Delete Image Item ~74
Permanently removes an image item from a board. Requires boards:write scope and is subject to Level 3 rate limiting.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the image item to delete. |
| item_id | string | yes | The unique identifier of the image item to delete from the board. |
No output schema declared.
No examples provided.
delete_item Delete Item ~67
Permanently removes an item from a board. This action cannot be undone and requires boards:write scope.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the item to delete. |
| item_id | string | yes | The unique identifier of the item to delete from the board. |
No output schema declared.
No examples provided.
delete_item_beta Delete Item ~69
Permanently removes an item from a board. This action cannot be undone and requires write access to the board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the item to delete. |
| item_id | string | yes | The unique identifier of the item to delete from the board. |
No output schema declared.
No examples provided.
delete_mindmap_node Delete Mindmap Node ~88
Permanently deletes a mind map node and all of its child nodes from a board. This operation requires write access to the board.
| Name | Type | Req | Description |
|---|---|---|---|
| board_id | string | yes | The unique identifier of the board containing the mind map node to delete. |
| item_id | string | yes | The unique identifier of the mind map node to delete. Deleting a node also removes all of its child nodes. |
No output schema declared.
No examples provided.
delete_project_in_team Delete Project in Team ~114
Permanently deletes a project (Space) from a team within an organization. Boards and users associated with the project remain in the team after deletion. Requires Enterprise plan and Company Admin role.
| Name | Type | Req | Description |
|---|---|---|---|
| org_id | string | yes | The organization ID from which the project will be deleted. Use the numeric organization identifier. |
| project_id | string | yes | The project ID to delete. Use the numeric project identifier. |
| team_id | string | yes | The team ID from which the project will be deleted. Use the numeric team identifier. |
No output schema declared.
No examples provided.
What is the com.mcparmory/miro MCP server?
com.mcparmory/miro is an MCP server listed in the public MCP registry as com.mcparmory/miro. Create and manage collaborative boards, items, and diagrams programmatically. This page covers its PyPI package (mcparmory-miro).
Is the com.mcparmory/miro MCP server safe to use?
com.mcparmory/miro scores 76 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the com.mcparmory/miro MCP server expose?
com.mcparmory/miro exposes 176 tools: get_access_token_info, list_audit_logs, update_team_boards_classification_bulk, get_board_data_classification, create_markdown_doc, and 171 more. Their descriptions and schemas cost roughly 26,826 tokens of context every time the server is loaded.
Is the com.mcparmory/miro MCP server still maintained?
com.mcparmory/miro is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.