pdauth

# pdauth — Dynamic OAuth for AI Agents

Use `pdauth` to give yourself (the agent) access to 2500+ APIs via OAuth. The flow:

1. Agent needs access to an app (Spotify, Slack, Notion, etc.)
2. Generate an OAuth link with `pdauth connect <app>`
3. Share link with user → they click and authorize
4. Agent can now call tools via `pdauth call <app.tool>`

## Quick Reference

```bash
# Configure (one-time setup)
pdauth config

# Search for apps
pdauth apps --search spotify

# Generate OAuth link
pdauth connect spotify --user USER_ID

# Check what's connected
pdauth status --user USER_ID

# List available tools
pdauth tools spotify --user USER_ID

# Call a tool
pdauth call spotify.get_my_playlists --user USER_ID
pdauth call slack.send_message channel=general text="Hello!"
```

## The OAuth Flow (How to Request Access)

When you need access to an app the user hasn't authorized:

```
1. Run: pdauth connect <app> --user <user_id>
2. Get the OAuth link from output
3. Send link to user: "To do this, I need access to <App>. Click here to authorize: <link>"
4. User clicks, authorizes via Pipedream
5. Confirm with: pdauth status --user <user_id>
6. Now you can call tools!
```

### User ID Strategy

Use a consistent identifier per user:
- Telegram: `telegram:5439689035`
- Email: `pedro@example.com`  
- Custom: `pedro-mainframe`

The same user ID across sessions maintains their connected accounts.

## Calling Tools

```bash
# Format: pdauth call <app>.<tool_name> [key=value ...]

# Simple args
pdauth call slack.send_message channel=general text="Hello"

# JSON args for complex data
pdauth call notion.create_page --args '{"title": "My Page", "content": "..."}'

# Get JSON output for parsing
pdauth call spotify.get_my_playlists --json
```

## Checking Status

```bash
# See what user has connected
pdauth status --user pedro

# See all users
pdauth status --all

# JSON for scripting
pdauth status --user pedro --json
```

## Popular Apps

Browse all at https://mcp.pipedream.com

| App | Sl...