--- name: pdauth-91ad2ff6dae7 description: Dynamic OAuth for AI agents via Pipedream. Generate OAuth links for 2500+ APIs, let users authorize, then call MCP tools on their behalf. homepage: https://github.com/Versatly/pdauth metadata: { "openclaw": { "emoji": "🔐", "requires": { "bins": ["pdauth"] }, "install": [ { "id": "node", "kind": "node", "package": "pdauth", "bins": ["pdauth"], "label": "Install pdauth (node)", }, ], }, } --- # 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 ` 3. Share link with user → they click and authorize 4. Agent can now call tools via `pdauth call ` ## 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 --user 2. Get the OAuth link from output 3. Send link to user: "To do this, I need access to . Click here to authorize: " 4. User clicks, authorizes via Pipedream 5. Confirm with: pdauth status --user 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 . [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 | Slug | Example Tools | |-----|------|---------------| | Slack | `slack` | send_message, list_channels | | Spotify | `spotify` | get_my_playlists, add_to_playlist | | Notion | `notion` | create_page, query_database | | Google Sheets | `google_sheets` | get_values, update_values | | Gmail | `gmail` | send_email, list_messages | | GitHub | `github` | create_issue, list_repos | | Linear | `linear` | create_issue, list_issues | | Airtable | `airtable` | list_records, create_record | ## Error Handling **"App not connected"** → Generate link with `pdauth connect` and ask user to authorize **"Tool not found"** → List available tools with `pdauth tools ` **"Invalid credentials"** → Run `pdauth config` to set up Pipedream credentials ## Tips 1. **Always check status first** before attempting tool calls 2. **Use consistent user IDs** so connections persist across sessions 3. **JSON output** (`--json`) is best for parsing results programmatically 4. **Link expiry** — OAuth links expire after 4 hours, generate fresh ones as needed ## Example Workflow ``` User: "Add 'Bohemian Rhapsody' to my Spotify playlist" Agent: 1. pdauth status --user telegram:5439689035 --json → No Spotify connection 2. pdauth connect spotify --user telegram:5439689035 → Gets OAuth link 3. Send to user: "I need Spotify access. Click here: " 4. User authorizes 5. pdauth status --user telegram:5439689035 → Spotify ✓ connected 6. pdauth call spotify.search_tracks query="Bohemian Rhapsody" --json → Get track ID 7. pdauth call spotify.add_to_playlist playlist_id=... track_id=... → Done! 8. Reply: "Added Bohemian Rhapsody to your playlist! 🎵" ``` --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/g9pedro/pdauth/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/g9pedro/pdauth/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Sales Roles: Business Development, Customer Success Manager, Growth Marketer, Product Marketer, Sales Development Rep (SDR) Specialties: API Tools: Airtable, GitHub, Gmail, Google Sheets, Linear, Notion, Slack Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: d45d328ee2a8c30eff3aae1db831d62a26fbefe7b3d927db33a772d55f947cc5