Miro Developer App icon

CONNECT APP

Build with Miro Developer App

The Visual Collaboration Platform for Every Team.

Web & App Development

  • API key

MCP

Give your agent Miro Developer App tools

Every Miro Developer App action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Miro Developer App account for each tool call — you store no tokens.

// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": "{project_id}",
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "miro_custom_app",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Board:
const result = await mcp.callTool({
  name: "miro_custom_app-create-board",
  arguments: {
    name: "Board Name",
    description: "Board Description",
  },
})

API PROXY

Call the Miro Developer App API directly

For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Miro Developer App API with the connected user's credentials attached. You store no tokens and write no refresh logic.

const resp = await pd.proxy.get({
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  accountId: "apn_xxxxxxx",
  url: "https://api.miro.com/v1/oauth-token",
})

// Any allowed Miro Developer App endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.

SDK

Run Miro Developer App actions from your backend

Connect a user's Miro Developer App account once, then run Create Board on their behalf from your own code — TypeScript, Python, or plain HTTP.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "miro_custom_app-create-board",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    miro_custom_app: { authProvisionId: "apn_xxxxxxx" },
    name: "Board Name",
    description: "Board Description",
  },
})

REFERENCE

App details

Reference metadata for the Miro Developer App connector in the Pipedream registry.

App slug
miro_custom_app
Authentication
API key
Categories
Web & App Development
Actions
14
Triggers
3
API proxy
Available