# Airweave — Pipedream Connect

> Build Smarter Agents

- API slug: `airweave` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Artificial Intelligence (AI)
- Website: https://airweave.ai
- This page (HTML): https://pipedream.com/apps/airweave
- Tools: 7 actions · 0 triggers

## 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: airweave`

```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": "airweave",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// e.g. run Create Collection:
const result = await mcp.callTool({
  name: "airweave-create-collection",
  arguments: {
    name: "Name",
    readableId: "Readable ID",
  },
})
```

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

## API proxy

For a Airweave 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.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?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: "airweave-create-collection",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    airweave: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    readableId: "Readable ID",
  },
})
```

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

## Actions (7)

### `airweave-create-collection` — Create Collection (Write)

Create a new Airweave collection. Collections are logical groups of data sources that provide unified search capabilities. The newly created collection is initially empty until you add source connections to it. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/create-collection.md

### `airweave-delete-collection` — Delete Collection (Write)

Delete a collection and all associated data. This permanently removes the collection including all synced data and source connections. This action cannot be undone. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/delete-collection.md

### `airweave-get-collection` — Get Collection (Read-only)

Retrieve details of a specific collection by its readable ID. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/get-collection.md

### `airweave-list-sources` — List Available Sources (Read-only)

List all available data source connectors. These are the types of integrations Airweave can connect to (e.g., GitHub, Slack, Google Drive, PostgreSQL, etc.). See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/list-sources.md

### `airweave-list-collections` — List Collections (Read-only)

List all collections in your organization. Collections are logical groups of data sources that provide unified search capabilities. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/list-collections.md

### `airweave-search-collection` — Search Collection (Read-only)

Search across all data sources within a collection using semantic and keyword search. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/search-collection.md

### `airweave-trigger-sync` — Trigger Source Connection Sync (Write)

Manually trigger a data sync for a source connection. The sync job runs asynchronously in the background and returns immediately with job details. See the documentation

Full schema: https://pipedream.com/apps/airweave/actions/trigger-sync.md

---

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