Activepieces MCP server

Activepieces is an open source automation tool that offers a type-safe framework for creating integrations through "pieces." These pieces are available as Model Context Protocol (MCP) servers that you can use with LLMs through applications like Claude Desktop, Cursor, or Windsurf.

Installation

To get started with Activepieces as an MCP server, follow these steps:

Prerequisites

Before installation, ensure you have:

• Node.js and npm installed
• Git installed (for cloning the repository)

Setting Up Activepieces

# Clone the repository
git clone https://github.com/activepieces/activepieces.git

# Navigate to the project directory
cd activepieces

# Install dependencies
npm install

Usage

Running the MCP Server

Once installed, you can start the Activepieces MCP server:

npm start

This will launch the server and make it available for connection through LLM tools.

Connecting to LLMs

You can connect your Activepieces MCP server to various LLM tools:

1. Claude Desktop: Open Claude Desktop and add a new MCP connection pointing to your Activepieces server URL.

2. Cursor: Configure Cursor to use your Activepieces MCP server as a context source.

3. Windsurf: Add your Activepieces server as an integration in Windsurf settings.

Working with Pieces

Activepieces comes with over 280 pre-built integrations (called "pieces") that are available as MCP servers. These include connections to popular services like:

• Google Sheets
• OpenAI
• Discord
• RSS feeds
• And many more

Creating Custom Flows

You can build automation flows using the visual builder:

1. Open the Activepieces dashboard
2. Create a new flow
3. Add triggers and actions using the available pieces
4. Configure each step with your desired settings
5. Test and activate your flow

Advanced Features

Activepieces offers several advanced capabilities:

• Loops and Branches: Create complex flows with conditional logic
• Auto Retries: Configure automatic retry behavior for failed steps
• HTTP Requests: Make direct API calls to any service
• Code with NPM: Write custom code with access to npm packages
• AI Assistance: Use the "ASK AI" feature in Code pieces

Troubleshooting

If you encounter issues while using Activepieces MCP server:

• Check the server logs for error messages
• Ensure your LLM tool is properly configured to connect to the MCP server
• Verify that your network allows the connection between the LLM and the MCP server

Getting Help

If you need assistance with Activepieces:

• Visit the official documentation
• Join the Activepieces Discord community
• Check the developer guides for creating custom pieces

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "activepieces" '{"command":"npx","args":["-y","@activepieces/cli"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "activepieces": {
            "command": "npx",
            "args": [
                "-y",
                "@activepieces/cli"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "activepieces": {
            "command": "npx",
            "args": [
                "-y",
                "@activepieces/cli"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect