How to Use the Miro MCP in Claude Code

Q: How do I add the Miro MCP server to my Claude Code CLI?

You run claude mcp add --transport http miro -- directly in your terminal shell. This registers the server in your local /.claude.json configuration file.

Q: Does Claude Code let me manage Miro board permissions?

You can use listboardmembers to inspect who has access to a specific board. While you cannot modify permissions directly with the current tools, you can easily audit who has collaborator access.

Manage Miro boards directly from your terminal or CI/CD pipelines using Claude Code commands.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Miro MCP to Claude Code

Create your Vinkius account to connect Miro to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Miro with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Script visual updates with the Claude Code MCP Server

Automating your deployment notifications is simple when Claude Code runs `create_sticky_note` to post build statuses to your team's Miro whiteboard. Our terminal agent catches the exit code of your build script and immediately drops a green or red sticky note onto the Miro canvas. Because the Claude Code CLI runs headless, you can pipe your terminal output directly into `list_boards` to find the correct target Miro board. This allows you to integrate visual Miro dashboards into your existing bash scripts.

Extract Miro board data for terminal pipelines

Parsing user feedback becomes scriptable when Claude Code calls `list_board_items` to download all Miro sticky notes from a brainstorming session. The terminal agent filters the raw JSON data, groups the feedback by keyword, and outputs a clean markdown summary. If you need to check the owner of the board, Claude Code runs `get_board_details` to fetch the administrative Miro metadata. Passing this metadata directly into other terminal utilities automates your team's documentation updates.

Mass-provision team boards from the command line

Provisioning workspaces for new projects is incredibly fast when Claude Code runs `create_board` over an MCP link in a loop. Feeding a list of project names from a text file directly to the CLI spins up dedicated Miro boards in seconds. The Claude Code agent then executes `list_organizations` to make sure each new Miro board is assigned to the correct corporate division. This eliminates manual setup errors and ensures your visual spaces are organized properly from day one.

Setup guide

Set up Miro MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see miro-alternative-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Miro transactions." It will automatically discover and invoke the available Miro tools.

Terminal

claude mcp add --transport http miro-alternative-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Miro MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "miro-alternative-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Miro. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Miro now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Miro MCP in Claude Code

You run `claude mcp add --transport http miro -- ` directly in your terminal shell. This registers the server in your local `~/.claude.json` configuration file.

Yes, Claude Code operates entirely in the terminal and can execute tools like `create_sticky_note` inside automated pipelines. This is perfect for posting automated status updates or test reports to shared visual boards.

You can use `list_board_members` to inspect who has access to a specific board. While you cannot modify permissions directly with the current tools, you can easily audit who has collaborator access.

Run Claude Code and ask it to list your workspaces. The agent will execute `list_boards` and print a clean, formatted list of all your active canvases directly in your terminal.

Your Miro developer tokens are stored locally in your system's secure configuration files. Since the server runs in a zero-trust V8 isolate sandbox, your credentials and board details are never exposed to external networks.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript