home / mcp / typebot mcp server

Typebot MCP Server

A MCP server that enables usage of Typebot’s REST API to create, list, get, update, delete, publish/unpublish Typebots.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hithereiamaliff-typebot-mcp": {
      "url": "https://your-typebot-domain.com/api/mcp",
      "headers": {
        "TYPEBOT_TOKEN": "YOUR_TYPEBOT_TOKEN",
        "TYPEBOT_API_URL": "https://your-typebot-domain.com/api/v1",
        "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
      }
    }
  }
}

You can expose Typebot’s REST API as MCP-ready tools to Claude Desktop and other MCP clients. This server lets you create, manage, publish, and chat with Typebots through natural-language commands, enabling seamless integration with your workflow.

How to use

You interact with the server by issuing natural-language requests through an MCP client. Use commands to manage Typebots, fetch results, and start chats. For example, you can create a new Typebot, list existing bots, update a bot’s name, publish or unpublish a bot, retrieve conversation results, or begin a chat session with a bot. Each action is mapped to a corresponding command you trigger from your MCP client, which the server interprets and executes against your Typebot workspace.

When you start a chat, the server creates a new session so you can have an ongoing conversation with a Typebot. If you need to modify a bot, provide the bot’s ID and the fields you want to change. You can also filter and paginate results when listing conversation histories.

How to install

Prerequisites you need before installing the MCP server:

- Node.js 18+ for running the server and building assets. - A valid Typebot API token and workspace ID to access your Typebot data. - Claude Desktop or another MCP client connected to your local MCP server.

# Option 1: Clone the repository
git clone <repo-url>
cd typebot-mcp
npm install
npm run build

# Option 2: Install via npm
npm install typebot-mcp
npm run dev # for development
# or
npm run build # for production build

# Option 3: Smithery deployment is discussed for hosting the MCP server externally

Available tools

createBot

Create a new Typebot in your workspace. Required: name. Optional: workspaceId, description.

listBots

List all Typebots in your workspace. Optional: workspaceId.

getBot

Fetch a Typebot by its ID. Required: botId.

updateBot

Patch an existing Typebot. Required: botId and typebot object with changes. Optional: overwrite.

deleteBot

Delete a Typebot by its ID. Required: botId.

publishBot

Publish a Typebot. Required: botId.

unpublishBot

Unpublish a Typebot. Required: botId.

listResults

Retrieve conversation results for a Typebot. Required: botId. Optional: limit, cursor, timeFilter, timeZone.

startChat

Begin a new chat session with a Typebot. Required: botId. Optional: chat.context.