Pipedream MCP

The Pipedream MCP node connects your SamaFlow agents to 3,000+ APIs and 10,000+ pre-built tools through Pipedream Connect. Your agents can send Slack messages, create GitHub issues, update Google Sheets, manage Notion pages, and much more — all using a standardized MCP (Model Context Protocol) interface with fully-managed OAuth.

1. Prerequisites

Before using the Pipedream MCP node you need:

• A Pipedream account: sign up at pipedream.com (free tier supports up to 1,000 connected accounts).
• A Pipedream Connect project: create one via the Pipedream dashboard or CLI (pd init connect).
• An OAuth client: generated inside your Pipedream workspace's API settings. This gives you a Client ID and Client Secret.

2. Setting Up Pipedream Credentials

2.1 Create an OAuth Client in Pipedream

1. Go to pipedream.com/settings/api.
2. Click New OAuth Client.
3. Name your client (e.g., SamaFlow Agent) and click Create.
4. Copy the Client Secret immediately, it will not be shown again.
5. Copy the Client ID from the list.

2.2 Find Your Project ID

1. Open your Pipedream project from the dashboard.
2. The Project ID is visible in the project settings (format: proj_xxxxxxx).

2.3 Add Credentials in SamaFlow

1. In SamaFlow, navigate to Credentials from the sidebar.
2. Click Add Credential and search for Pipedream Connect.
3. Fill in the following fields:

1. Click Save.

Tip: For production environments, use the narrowest scopes you need. See Pipedream Authentication Docs for available scopes.

3. Adding the Pipedream MCP Node

1. Openan agentflow in the SamaFlow canvas.
2. Add an Agent node.
3. From the Tools (MCP) category, select Pipedream MCP.
4. Configure the node (see next section).

4. Node Configuration Reference

5. Selecting Actions

Once you provide a valid App Slug and User ID, click the refresh icon next to Available Actions. The node will connect to Pipedream's remote MCP server and retrieve all available tools for the specified app.

Each action is listed with:

• Name: the tool identifier (displayed in uppercase), e.g., GITHUB-GET-REPOSITORY
• Description: what the tool does, e.g., "Get Information for a specific repository"

Select only the actions your agent needs. Fewer tools help the LLM make better decisions and reduce token usage.

Finding App Slugs

The app slug is the lowercase name shown in the URL on Pipedream. For example:

• pipedream.com/apps/slack → slug is slack
• pipedream.com/apps/google-sheets → slug is google-sheets
• pipedream.com/apps/notion → slug is notion

Browse the full catalog at mcp.pipedream.com or pipedream.com/explore.

6. Account Connection Flow

When an agent invokes a Pipedream tool for a user who has not yet connected their account for that app, Pipedream returns a Connect URL. The Pipedream MCP node automatically detects this and provides the connect URL to the user. The connect URL opens a Pipedream hosted page where the user authorizes the app (e.g., signs in to Slack via OAuth). The link is scoped to the specific user and expires after 4 hours.

Key points:

• The connect URL renders as a clickable link in the chat UI.
• Once the user connects their account, subsequent tool calls will execute normally.
• User credentials are encrypted at rest on Pipedream's servers and never exposed to the LLM.

7. Using Variables for User ID

The User ID field identifies the end user in Pipedream Connect. This is critical for multi-user scenarios where each user connects their own accounts.

Supported Variable Types

Workspace Variables

1. In SamaFlow, go to Variables from the sidebar.
2. Create a variable (e.g., user_email with value john@example.com).
3. In the Pipedream MCP node, set User ID to {{$vars.user_email}}.

Flow Variables

Use {{$flow.sessionId}} to automatically scope Pipedream accounts per chat session. This is useful when each session represents a different user.

Important: Flow variables like {{$flow.sessionId}} are only resolved at runtime. When clicking "refresh" on Available Actions in the editor, the node uses a fallback preview user ID (flowise_preview_user) so that action listing still works.

Static User ID

For single-user or testing scenarios, you can also enter a plain string like test-user-1 or admin@mycompany.com.

Allowed characters: Letters, digits, . _ @ + - (max 250 characters).

8. Security Best Practices

9. External References