Build with Gmail + IMAP

// 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": "gmail,imap",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// One list, both toolsets: Gmail and IMAP tools arrive
// together, each keyed by its own app's slug.

// e.g. run Add Label to Email:
const result = await mcp.callTool({
  name: "gmail-add-label-to-email",
  arguments: {
    message: "Message",
    addLabelIds: ["Labels"],
  },
})

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 externalUserId = "{external_user_id}" // any stable ID for this user in your system

const [gmailTools, imapTools] =
  await Promise.all([
    pd.components.list({ app: "gmail" }),
    pd.components.list({ app: "imap" }),
  ])

// One external user owns both connected accounts, so either app's tools
// run on their behalf with the same externalUserId.

curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=gmail" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}"

curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=imap" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}"

# Connect both accounts to the same external_user_id, then
# configure and invoke either app's tools on that user's behalf.