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.

---

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

---

Prerequisites

1. Node.js 18+

2. A valid Typebot API token and workspace ID

3. Claude Desktop connected to your local MCP server

---

Installation

git clone 
cd mcp-typebot
npm install
npm run build

---

You can also install the published package directly via npm:

npm install mcp-typebot
npm start

---

Running

npm start

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

---

Usage in Claude Desktop

Simply write natural commands like:

User: “Create me a new typebot”

Claude: “Sure—what name?”

User: “MyDemoBot”

Claude (internally invokes):

```

@createBot {"name":"MyDemoBot"}

```

Or, explicitly:

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

You can also start a chat:

@startChat {"botId":""}

---

Extending

• 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.

---

License

---

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.