🔐 pdauth

Pipedream OAuth CLI — Give AI agents access to 2500+ APIs via dynamic OAuth

Agent: "I need Spotify access to manage your playlist"
  ↓
$ pdauth connect spotify
  ↓  
🔗 https://pipedream.com/_static/connect.html?token=ctok_xxx&app=spotify
  ↓
User clicks → OAuth flow → Done
  ↓
Agent can now call Spotify tools via MCP

Installation

npm install -g pdauth

Quick Start

1. Configure Pipedream credentials

Get your credentials at https://pipedream.com/settings/api

pdauth config

Or set directly:

pdauth config --set clientId=YOUR_CLIENT_ID
pdauth config --set clientSecret=YOUR_CLIENT_SECRET
pdauth config --set projectId=YOUR_PROJECT_ID

2. Generate OAuth link for any app

# Generate link for Spotify
pdauth connect spotify

# Generate for a specific user
pdauth connect google_sheets --user [email protected]

# Copy to clipboard
pdauth connect slack --copy

3. Check connection status

# Show connected accounts
pdauth status

# Show all users
pdauth status --all

# JSON output for scripts
pdauth status --json

4. Use connected tools

# List available tools for an app
pdauth tools slack

# Call a tool
pdauth call slack.send_message channel=general text="Hello from AI!"

# Call with JSON args
pdauth call notion.create_page --args '{"title": "New Page", "parent_id": "..."}'

Commands

| Command | Description | |---------|-------------| | pdauth config | Configure Pipedream credentials | | pdauth apps [--search <query>] | List available apps (2500+) | | pdauth app <slug> | Get info about an app | | pdauth connect <app> | Generate OAuth link | | pdauth status | List connected accounts | | pdauth disconnect <app> | Revoke app access | | pdauth tools <app> | List MCP tools for an app | | pdauth call <app.tool> | Invoke an MCP tool |

Options

All commands support:

• -u, --user <id> — Specify user ID (default: "default")
• -j, --json — Output as JSON

How It Works

1. You run pdauth connect <app> → generates a secure OAuth link
2. User clicks the link → Pipedream handles OAuth flow
3. Credentials stored securely in Pipedream (not locally)
4. Agent calls tools via MCP using pdauth call or direct MCP

Powered by Pipedream Connect — managed OAuth for 2500+ APIs.

For AI Agents (OpenClaw)

This CLI is designed for AI agents to request and use OAuth access dynamically:

User: "Add this song to my Spotify playlist"

Agent: I need Spotify access. Here's a link to authorize:
       https://pipedream.com/_static/connect.html?token=...

User: *clicks, authorizes*

Agent: *calls pdauth call spotify.add_to_playlist ...*
       ✓ Added "Song Name" to your playlist!

Environment Variables

Instead of pdauth config, you can use environment variables:

export PIPEDREAM_CLIENT_ID=your_client_id
export PIPEDREAM_CLIENT_SECRET=your_client_secret
export PIPEDREAM_PROJECT_ID=your_project_id
export PIPEDREAM_ENVIRONMENT=development  # or production

Links

• Pipedream MCP — Browse all available apps
• Pipedream Connect Docs
• OpenClaw — AI agent platform

License

MIT © Versatly