ConnectMCPDevelopers

Deploy Pipedream MCP to your agent

Deploy Pipedream’s MCP servers to your application or agent and make authenticated request on behalf of your customers. Refer to our reference implementation here.

Quickstart

Prerequisites

To run your own MCP server, you’ll need:

  1. A Pipedream account
  2. A Pipedream project. Accounts connected via MCP will be stored here.
  3. Pipedream OAuth credentials

Set up environment variables

Set the following environment variables:

PIPEDREAM_CLIENT_ID=your_client_id
PIPEDREAM_CLIENT_SECRET=your_client_secret
PIPEDREAM_PROJECT_ID=your_project_id
PIPEDREAM_ENVIRONMENT=development

Run the MCP server

Pipedream’s MCP servers can run in two modes:

Stdio (for local testing)
npx @pipedream/mcp stdio --app slack --external-user-id user123
SSE (for hosting)
npx @pipedream/mcp sse

This exposes routes at:

  • GET /:external_user_id/:app - App-specific SSE connection endpoint
  • POST /:external_user_id/:app/messages - App-specific message handler

Where:

  • :external_user_id is your user’s unique identifier in your system
  • :app is the app slug (e.g., “slack”, “github”)

Customize for your needs

You can host and customize the MCP server for your specific requirements:

# Clone the repo
git clone https://github.com/PipedreamHQ/pipedream
cd pipedream/modelcontextprotocol
 
# Install dependencies
npm install
 
# Build
npm run build
 
# Run the SSE server
npm run start:sse:prod

See the MCP server README for detailed instructions on customization options.

OverviewConsumers