X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Formbricks to Claude

Connect Claude Web, Desktop and Cowork to Formbricks MCP. Create a new customer feedback survey, add a contact to our user list, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Formbricks logoFormbricks
Api Key

Formbricks is an open-source platform for building and managing surveys. It helps organizations collect and analyze user feedback efficiently.

45 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Formbricks account to Claude via Composio Connect, enabling it to create a new customer feedback survey, add a contact to our user list, record survey responses from yesterday's event, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Formbricks with

OpenAI Agents SDKClaude Agent SDKClaude CodeCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Formbricks to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Formbricks account

Back in Claude, ask it to connect to Formbricks or give it any Formbricks-related task.

For example, ask Claude to:

  • "Create a new customer feedback survey"
  • "Add a contact to our user list"
  • "Record survey responses from yesterday's event"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Formbricks account is ready to use.

What is the Formbricks Claude Connector, and what's possible with it?

The Formbricks MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Formbricks account. It provides structured and secure access to your survey management tools, so your agent can perform actions like creating surveys, collecting responses, managing contacts, and handling webhooks automatically on your behalf.

  • Survey creation and management: Easily instruct your agent to create new surveys, define questions, and set up feedback forms tailored to your needs.
  • Automated response collection: Have your agent log responses to surveys, link displays to responses, and streamline data gathering effortlessly.
  • Contact and attribute management: Direct your agent to add or remove contacts, create or delete attribute classes, and segment audiences for more targeted feedback analysis.
  • Webhook configuration for real-time events: Let your agent register new webhooks to automatically send survey response data to external systems or endpoints.
  • Cleanup and maintenance tools: Authorize your agent to delete surveys, survey responses, persons, or unused attributes, keeping your Formbricks workspace organized and up to date.

Troubleshooting

1. Why does Claude not use the Composio connector for Formbricks?

The connector can show as connected, but Claude must use it in each Formbricks conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Formbricks again.

2. Why does Claude show an MCP server error before Formbricks connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Formbricks.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Formbricks.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Formbricks authorization link not work?

The Composio connector is one server. Your Formbricks account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Formbricks connection.
  • Composio creates a fresh Formbricks authorization link.
  • Open that link in your browser and finish the Formbricks sign-in.

4. Why do Formbricks actions fail after they worked before?

The Formbricks connection can expire or lose permission.

  • Ask Claude to inspect the Formbricks connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Formbricks account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Formbricks.
  • If the action still fails with a permission error, check that the connected account has that permission in Formbricks itself.

5. How do I switch to a different Formbricks account?

Claude can manage the Formbricks connection for you.

  • Ask Claude to disconnect or delete the current Formbricks account.
  • Ask Claude to connect Formbricks again.
  • Open the new Composio authorization link for Formbricks.
  • Sign in with the other Formbricks account in the browser.
  • After the account connects, ask Claude to retry the Formbricks task.

6. Why is my Formbricks connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Formbricks connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Formbricks tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Formbricks.
TOOLS

Supported Tools

Every Formbricks action and event your agent gets out of the box.

Check Health

Tool to check the health status of the Formbricks API.

Create Action Class

Tool to create a new action class.

Create Attribute Class

Creates a new attribute class (custom contact attribute) in Formbricks.

Create Client User

Tool to create or identify a user within a specified environment.

Create Contact

Creates a new contact in a Formbricks environment.

Create Display

Create a display record to track when a survey is shown to users.

Create Survey Response

Tool to create a response for a survey.

Create Survey

Tool to create a new survey.

Create Webhook

Tool to create a new webhook.

Delete Attribute Class

Tool to delete an attribute class.

Delete Person

Tool to delete a person.

Delete Survey Response

Tool to delete a survey response by its ID.

Delete Survey

Deletes a survey from Formbricks by its unique identifier.

Delete Team

Tool to delete an organization team by its ID.

Delete Webhook

Tool to delete a webhook by ID.

Get Account Info

Retrieves environment information for the authenticated API key.

Get All Contacts

Tool to retrieve all contacts within the organization.

Get Attribute Class

Tool to get a specific attribute class by ID.

Get Client Contacts State

Tool to get the current state of a contact including surveys and segment information.

Get Contact Attribute Key

Tool to retrieve detailed information about a specific contact attribute key by ID (v2 API).

Get Contact by ID

Tool to retrieve a specific contact by its ID.

Get Me

Tool to retrieve current authenticated organization's and environment details.

Get Person by ID

Tool to retrieve a person by their internal ID in Formbricks.

Get Responses

Retrieve survey responses with flexible filtering, sorting, and pagination.

Get Roles

Tool to retrieve all available roles in the system.

Get Webhook

Tool to retrieve details of a specific webhook.

List Action Classes

List all action classes in your Formbricks environment.

List Attribute Classes

Tool to list all attribute classes.

List Client Environment

Tool to retrieve environment state for Formbricks SDKs.

List Contact Attribute Keys

Tool to retrieve contact attribute keys from Formbricks.

List Health

Tool to check the health status of critical application dependencies including database and cache.

List Management Contact Attributes

Tool to retrieve all contact attributes in the environment.

List Management Me

Tool to retrieve authenticated user's environment and project information.

List Management People

Tool to retrieve all people (legacy term for contacts) in the environment.

List Organizations Project Teams

Tool to list all project-team assignments for an organization (v2 API only).

List Organization Teams

Tool to retrieve all teams in an organization (v2 API).

List Surveys

List all surveys in the environment.

List Webhooks

List all webhooks configured for the current environment.

Update Contact Attributes

Tool to update a contact's attributes in Formbricks.

Update Survey Response

Tool to update an existing survey response.

Update Survey

Updates an existing Formbricks survey with new properties.

Update Webhook

Tool to update an existing webhook.

Upload Bulk Contacts

Upload multiple contacts to a Formbricks environment in bulk (up to 250 per request).

Upload Private File

Tool to obtain S3 presigned upload data for a private survey file.

Upload Public File

Retrieves S3 presigned upload URLs and form fields for uploading a public file to Formbricks storage.

FRAMEWORKS

How to build Formbricks MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Formbricks MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Formbricks MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Formbricks MCP with Claude Code

Codex logo

Codex

Use Formbricks MCP with Codex

OpenClaw logo

OpenClaw

Use Formbricks MCP with OpenClaw

Hermes logo

Hermes

Use Formbricks MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Formbricks MCP with Atomic Agent

Google ADK logo

Google ADK

Use Formbricks MCP with Google ADK

LangChain logo

LangChain

Use Formbricks MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Formbricks MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Formbricks MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Formbricks MCP with LlamaIndex

CrewAI logo

CrewAI

Use Formbricks MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Formbricks MCP with Pydantic AI

AutoGen logo

AutoGen

Use Formbricks MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Formbricks MCP server, the agents and LLMs can only access a fixed set of Formbricks tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Formbricks and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Formbricks tools.

Yes, absolutely. You can configure which Formbricks scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Formbricks data and credentials are handled as safely as possible.

Start with Formbricks.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Formbricks tool your agent needs.Free to start.

Start building