Skip to main content
The @guildai-services/guildai~pipedream package provides agents with tool-based access to Notion and Google Docs via Pipedream Connect and MCP (Model Context Protocol).

​
Authentication

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

​
Setup

1

Open Credentials

Go to Credentials in Guild.
2

Connect a service

Click Notion or Google Docs.
3

Authorize through Pipedream

You’ll be redirected to Pipedream to connect your account and authorize access.

​
Supported services

ServicePipedream app slug
Notionnotion
Google Docsgoogle_docs

​
Usage

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

OperationMethodPathDescription
pipedream_callPOST/{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

  • Pages — create, read, update, search
  • Databases — query, create entries
  • Blocks — read, append, update
  • Comments — create, read
  • Documents — create, read, update
  • Content — insert, replace, delete text
  • Formatting — apply styles
  • Search — find and replace content

​
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