# Use bitHuman in Claude

URL: https://docs.bithuman.ai/build/claude

> Add bitHuman characters to Claude for talking clips and live voice chats.

Add bitHuman to Claude as a connector and its AI characters speak in your chat: ask one to say a line and a short video clip plays, or open a live voice conversation with it. You don't need a bitHuman account. The short version, with a QR code for your phone, is at [bithuman.ai/mcp](https://www.bithuman.ai/mcp?app=claude&utm_source=docs&utm_medium=referral&utm_campaign=agentic-apps-launch).

## What you'll build

A Claude chat (web, desktop or mobile) where you can:

- see bitHuman's characters, with a picture of each
- have one say your exact words (3 to 200 characters, about 15 seconds) as a video clip you can download or share
- talk to one live, by voice, for up to a minute

## Steps

### Add the connector

1. On claude.ai, open **Settings → Connectors** and choose **Add custom connector**.
2. Name: `bitHuman`. URL: `https://mcp.bithuman.ai/mcp`. Leave the sign-in fields empty, then **Add**.

The connector then works in Claude on the web, the desktop app and the mobile apps.

Expected:

bitHuman is listed under Settings → Connectors.

### Claude Code

```bash
claude mcp add --transport http bithuman https://mcp.bithuman.ai/mcp
```

The same command with a copy button: [bithuman.ai/mcp, Claude Code tab](https://www.bithuman.ai/mcp?app=code&utm_source=docs&utm_medium=referral&utm_campaign=agentic-apps-launch).

Expected:

`claude mcp list` shows `bithuman` as connected.

### Try it

In a new chat, ask:

- "Show me the bitHuman characters."
- "Make Gio say: Welcome to the team, everyone!"
- "Have Wise Pup explain photosynthesis in one sentence."
- "Let me talk to Pip live."

Expected:

A row of character cards appears in the chat; asking for a line plays a short clip of that character saying it.

## How it works

Claude writes the words; bitHuman voices them and animates the character on its own servers, then the clip plays in the chat. A live conversation runs inside the chat, with **Open in a new tab** as a fallback. Each person can make 10 new clips a day, and asking for the same line again replays it. Clips are kept for 7 days. What is stored, and for how long: [bitHuman in ChatGPT and Claude](https://docs.bithuman.ai/legal/mcp-server).

## Make it your own

The connector speaks only as bitHuman's own characters. To use your own avatar or voice, [create an agent](https://docs.bithuman.ai/build/create-avatar) and add the [CLI's MCP server](https://docs.bithuman.ai/build/mcp) to Claude Code or Claude Desktop instead.

## Troubleshooting

| Symptom | Fix |
|---|---|
| Claude doesn't use bitHuman | name it in the prompt ("bitHuman characters"), and check the connector is on for the chat |
| New features or characters don't show after an update | Claude keeps the old version: **Settings → Connectors → bitHuman → Disconnect**, then **Connect** |
| The live call shows a black screen | choose **Open in a new tab** |
| "Daily limit reached" | 10 new clips per person per day; a line you already made replays |

## Next

- [Use bitHuman in ChatGPT](https://docs.bithuman.ai/build/chatgpt)
- [Claude & Cursor (MCP)](https://docs.bithuman.ai/build/mcp), for your own avatars from the CLI
- [What the connector stores](https://docs.bithuman.ai/legal/mcp-server)