MCP Typebot

🚀 MCP-Typebot

A small MCP server that exposes Typebot’s REST API as callable tools in Claude Desktop (via STDIO). You can create, list, get, update, delete, publish/unpublish Typebots, list results, and start chats using natural - language commands.

🚀 Quick Start

The MCP-Typebot allows you to interact with Typebots using natural - language commands in Claude Desktop. You can perform various operations such as creating, listing, getting, updating, deleting, publishing/unpublishing Typebots, listing results, and starting chats.

✨ Features

• 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 (e.g., rename).

  • Required: botId, typebot (object with fields to change)
  • Optional: overwrite

• deleteBot: Delete a Typebot by its ID.

  • Required: botId

• publishBot / unpublishBot: Toggle a Typebot’s published state.

  • 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

📦 Installation

You can install the project in two ways:

Clone from the repository

git clone <repo-url>
cd mcp-typebot
npm install
npm run build

Install via npm

npm install mcp-typebot
npm start

💻 Usage Examples

Basic Usage

In Claude Desktop, you can use natural - language commands to interact with Typebots. For example:

> **User**: “Create me a new typebot”
> **Claude**: “Sure—what name?”
> **User**: “MyDemoBot”
> **Claude** (internally invokes):
> ```
> @createBot {"name":"MyDemoBot"}
> ```

Advanced Usage

You can also use explicit commands:

@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}

To start a chat:

@startChat {"botId":"<your_bot_id>"}

🔧 Technical Details

Prerequisites

1. Node.js 18+
2. A valid Typebot API token and workspace ID
3. Claude Desktop connected to your local MCP server

Running the Server

npm start

This starts the MCP server on STDIO. Claude Desktop (or any MCP client) will connect to it automatically.

Extending the Project

• Add new tools by implementing them in src/tools/bots.ts and registering them in src/index.ts.
• Define a Zod schema for each tool to get automatic prompting and validation.

Configuring Claude Desktop

To connect Claude Desktop to this MCP server, add the following to your Claude configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-typebot": {
      "command": "node",
      "args": [
        "path/to/project/dist/index.js"
      ],
      "env": {
        "TYPEBOT_TOKEN": "YOUR_TOKEN_HERE",
        "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
      }
    }
  }
}

Make sure the command and args point to your local built index.js, and that your .env values match those in env.