How to Use the Activepieces MCP in Cursor

Q: How do I manage project spaces in Activepieces using Cursor?

You use createproject to spin up a new space and listprojectmembers to verify who has access. The agent handles the workspace setup while you focus on writing code.

Q: How do I update existing flow steps?

You run applyflowoperation to send structural changes directly to the flow. The agent handles the payload formatting so you do not have to write manual JSON operations.

Write code and manage Activepieces automation flows directly inside Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Activepieces MCP to Cursor

Create your Vinkius account to connect Activepieces to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Activepieces with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Activepieces automations while you write code

The `create_flow` tool builds new automation flows directly from your editor. This MCP Server exposes your automation pipeline directly to your sidebar, allowing you to structure steps using `apply_flow_operation`. Your editor reads the local codebase and matches it with your cloud integrations. You do not have to leave your IDE to align your backend code with your Activepieces setups.

Sync your Cursor workspace with Git via MCP Server

The `configure_git_repo` tool links your Activepieces projects directly to your Git repository. You track changes, push updates, and handle version control with `create_project_release` right from the terminal. This keeps your cloud automations completely in sync with your local git branches. The agent coordinates the releases so your team always runs the latest tested flow version.

Query and update internal tables instantly

The `list_tables` tool fetches your Activepieces internal database structure directly into your editor. You can read current rows with `list_records` and modify specific entries using `update_record` as you debug. This eliminates the need to run separate database clients. Your editor reads and updates live data records on the fly using the MCP connection during local testing.

Setup guide

Set up Activepieces MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Activepieces MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Activepieces transactions." If the MCP tools are loaded correctly, Cursor will call the Activepieces tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "activepieces-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Activepieces. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Activepieces now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Activepieces MCP in Cursor

Add the server to your .cursor/mcp.json configuration file. Once added, Cursor's agent mode can call MCP tools like `list_flows` to read your active automations.

Yes. You can write your custom integration code in your editor, and then use the `add_piece` tool to upload it directly to your Activepieces instance.

You use `create_project` to spin up a new space and `list_project_members` to verify who has access. The agent handles the workspace setup while you focus on writing code.

You run `apply_flow_operation` to send structural changes directly to the flow. The agent handles the payload formatting so you do not have to write manual JSON operations.

Your sensitive API credentials and flow records remain inside your local environment and your Activepieces account. This integration uses a zero-trust architecture, passing tokens directly to the endpoint without persistent caching on intermediate servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript