# Fathom — Pipedream Connect

> Fathom summarizes your meetings so you can focus on the conversation.

- API slug: `fathom` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Artificial Intelligence (AI)
- Website: https://www.fathom.ai
- Managed OAuth scopes: `public_api`
- This page (HTML): https://pipedream.com/apps/fathom
- Tools: 9 actions · 1 trigger

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: fathom`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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": "fathom",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// e.g. run Get Recording Download Status:
const result = await mcp.callTool({
  name: "fathom-get-recording-download-status",
  arguments: {
    recordingId: "Recording ID",
    downloadId: "Download ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Fathom endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.fathom.ai/external/v1/teams

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZmF0aG9tLmFpL2V4dGVybmFsL3YxL3RlYW1z?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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: "fathom-get-recording-download-status",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    fathom: { authProvisionId: "apn_xxxxxxx" },
    recordingId: "Recording ID",
    downloadId: "Download ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (9)

### `fathom-get-recording-download-status` — Get Recording Download Status (Read-only)

Check the status of a previously requested recording download and, once completed, get the signed video/audio download URLs. Use Request Recording Download first to obtain a Download ID. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/get-recording-download-status.md

### `fathom-get-recording-summary` — Get Recording Summary (Read-only)

Get the summary of a recording. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/get-recording-summary.md

### `fathom-get-recording-transcript` — Get Recording Transcript (Read-only)

Get the transcript of a recording. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/get-recording-transcript.md

### `fathom-list-meeting-types` — List Meeting Types (Read-only)

List the meeting types configured for the account (e.g. Quarterly Business Review), including whether each is currently active or inactive. Use this to discover valid meeting type names before filtering meetings by type. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/list-meeting-types.md

### `fathom-list-meetings` — List Meetings (Read-only)

List meetings. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/list-meetings.md

### `fathom-list-team-members` — List Team Members (Read-only)

List the members of a team, or all team members across the account. Use List Teams to find a valid team name to filter by. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/list-team-members.md

### `fathom-list-teams` — List Teams (Read-only)

List the teams configured for the account. Use this to discover valid team names before filtering List Team Members, List Users and Permissions, or other team-scoped tools. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/list-teams.md

### `fathom-list-users` — List Users and Permissions (Read-only)

List the users on the account and their admin permissions (settings access level and view access). Admin-only — the connected account must have account_admin settings access, or the request fails with a 403 error. Use List Teams to find a valid team name to filter by. See the documentation

Full schema: https://pipedream.com/apps/fathom/actions/list-users.md

### `fathom-request-recording-download` — Request Recording Download (Write)

Request a downloadable video/audio file for a recording. The initial response may already have status: completed with the signed download URL included (common for audio-only recordings, which finish synchronously) — use that URL right away in this case. Otherwise the response returns status…

Full schema: https://pipedream.com/apps/fathom/actions/request-recording-download.md

## Triggers (1)

### `fathom-new-recording` — New Recording (Instant) (Instant)

Emit new event when a new recording is created. See the documentation

Full schema: https://pipedream.com/apps/fathom/triggers/new-recording.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt