Pipedream Connect provides a developer toolkit that lets you add + integrations to your app or AI agent. The fastest way to get started is with the Pipedream CLI. In this quickstart, you’ll:
  • Install the Pipedream CLI
  • Create a Connect project
  • Set up a Pipedream OAuth client to authenticate API requests
  • Run the SDK playground locally to explore the Pipedream SDK and pre-built tools

Set up Connect with the CLI

1

Install the Pipedream CLI

Using Homebrew:
brew tap pipedreamhq/pd-cli
brew install pipedreamhq/pd-cli/pipedream
From source:
curl https://cli.pipedream.com/install | sh
Verify the installation:
pd --version
2

Log in to your account

Authenticate with your Pipedream account:
pd login
This opens your browser to complete sign in.
3

Initialize a Connect project

Run the Connect initialization command:
pd init connect
This command walks you through:
  • Creating a new project (or selecting an existing one)
  • Setting up a Pipedream OAuth client to authenticate requests to the Connect API
  • Choosing one of the available demo apps to get started:
    • Next.js app for managed auth: a basic Next.js application demonstrating how your users can connect their accounts
    • SDK Playground: an interactive playground that highlights both the frontend connect-react and backend @pipedream/sdk libraries for integrating 10,000+ pre-built triggers and actions
    • MCP Chat App: an AI chat application powered by Pipedream’s MCP server
The CLI automatically creates a .env file with your OAuth client credentials and project ID. Keep this file secure and don’t commit it to version control.
4

Start your chosen demo app

After initialization, start the demo app you selected:
cd your-project-name
npm run dev
Open http://localhost:3000 to see your app running.
This demo showcases:
  • User authentication - Sign in flows for your end users
  • Account connections - Connect user accounts to + apps
  • Basic integration patterns - Common use cases and implementation examples
5

Run the demo app

Follow the instructions in the CLI to set up your local environment and run the app.

Next steps