View as Markdown
Readwise icon Supernotes icon

MULTI-APP TOOLKIT

Build with Readwise + Supernotes

Connect a user's Readwise and Supernotes accounts and expose tools for both apps directly in your product or your agent.
  • Multi-app
  • One MCP session
  • 4 actions
  • 2 triggers
  • Managed auth

MCP

One MCP session, both toolsets

One session gives your product or agent every Readwise and Supernotes tool at once — connect once, list tools, and call them like any single-app session.

// 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": "readwise,supernotes",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

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

// e.g. run Get Highlight Details:
const result = await mcp.callTool({
  name: "readwise-get-highlight-details",
  arguments: {
    bookId: 10,
    highlightId: 10,
  },
})

ARCHITECTURE

One user, two connected accounts

Your user connects each account once, under whatever ID they already have in your product. The two stay independent — either can be revoked on its own — and your code reaches both through that one user.

Your product

external_user_id

{external_user_id}

Pipedream Connect

Managed identity

Auth · tools · routing

Readwise

Connected account

Supernotes

Connected account

TOOLS

Supernotes tools

The Supernotes tools this pairing puts in reach, each one running on your user's own connected account.

View all 1 Supernotes tools →
x-pd-app-slug
readwise,supernotes
Primary app
Readwise (readwise)
Second app
Supernotes (supernotes)
Authentication
API key + API key
Available actions
4
Available triggers
2