> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedream (Notion & Google Docs)

> Give agents access to Notion and Google Docs through Pipedream Connect.

The `@guildai-services/guildai~pipedream` package provides agents with tool-based access to Notion and Google Docs via [Pipedream Connect](https://pipedream.com/docs/connect/) and MCP (Model Context Protocol).

## Authentication

* **Type:** Pipedream Connect (OAuth handled by Pipedream)
* **Token management:** Handled entirely by Pipedream

### Setup

<Steps>
  <Step title="Open Credentials">Go to **Credentials** in Guild.</Step>
  <Step title="Connect a service">Click **Notion** or **Google Docs**.</Step>
  <Step title="Authorize through Pipedream">You'll be redirected to Pipedream to connect your account and authorize access.</Step>
</Steps>

## Supported services

| Service     | Pipedream app slug |
| ----------- | ------------------ |
| Notion      | `notion`           |
| Google Docs | `google_docs`      |

## Usage

```typescript theme={null}
import { pipedreamTools } from "@guildai-services/guildai~pipedream"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that works with Notion and Google Docs",
  tools: { ...pipedreamTools },
})
```

## How it works

Rather than proxying HTTP API calls directly, Pipedream integrations use MCP tools. Agents describe what they need using natural language instructions, which are dispatched to the appropriate MCP tools provided by Pipedream.

## API endpoints

| Operation        | Method | Path         | Description                                                                                |
| ---------------- | ------ | ------------ | ------------------------------------------------------------------------------------------ |
| `pipedream_call` | POST   | `/{service}` | Execute a natural language instruction using Pipedream MCP tools for the specified service |

The `{service}` path parameter specifies which integration to use (e.g., `notion`, `google_docs`).

### Available operations

<AccordionGroup>
  <Accordion title="Notion">
    * **Pages** — create, read, update, search
    * **Databases** — query, create entries
    * **Blocks** — read, append, update
    * **Comments** — create, read
  </Accordion>

  <Accordion title="Google Docs">
    * **Documents** — create, read, update
    * **Content** — insert, replace, delete text
    * **Formatting** — apply styles
    * **Search** — find and replace content
  </Accordion>
</AccordionGroup>

## Webhook events

Pipedream integrations do not support webhook triggers in Guild. These integrations are API-access only.

## Limitations

* Tool availability depends on Pipedream's MCP integration for each service
* Operations go through Pipedream as a proxy, adding a network hop
* Only Google Docs is supported (not Google Sheets, Slides, or other Google services)
* No webhook or trigger support