Teambox
MCP Connector

The Teambox Claude Connector

Connect your Teambox account to Claude and manage your WhatsApp Business CRM through natural conversation — read chats, send replies, and analyze campaigns without leaving Claude.

Get MCP URL from Settings Setup guide

What you can do

Once connected, ask Claude anything about your Teambox in plain English:

  • “Show me my open Teambox conversations from the last 24 hours”
  • “Find all contacts tagged "vip" who haven't been messaged in 30 days”
  • “Reply to Ahmed's conversation saying I'll be with him in 5 minutes”
  • “How did my last broadcast campaign perform? Give me delivery + reply rates.”
  • “Mark that conversation as resolved and tag the contact as "customer"”

Setup — takes 2 minutes

1

Copy your MCP endpoint URL

Your Teambox exposes a single URL that Claude uses to talk to your workspace:

https://app.teambox.app/mcp Copy

You can also copy it from Teambox → Settings → Integrations → Claude & AI Assistants.

2

Add the connector in Claude

Claude.ai (web)

  1. Open claude.ai
  2. Click Customize → Connectors
  3. Click Add custom connector
  4. Name: Teambox
  5. Remote MCP server URL: paste the URL above
  6. Leave OAuth Client ID and Secret blank — Claude registers automatically
  7. Click Add

Claude Desktop

  1. Open the Claude Desktop app
  2. Settings → Connectors → Add Custom Connector
  3. Paste the same URL
3

Authorize your Teambox organization

Claude redirects you to Teambox where you sign in (if you weren't already) and review the permissions Claude is requesting. Click Allow access and you're done — Claude will have the tools ready in your next chat.

On claude.ai, make sure the Teambox connector is toggled ON in your chat's tool selector before asking.

4

Try it

Ask Claude:

Show me my open Teambox conversations

Available tools

Read-only (5)

  • list_conversations

    Filter open, resolved, or all conversations. Search by contact.

  • read_conversation

    Get the recent messages of one conversation for context.

  • search_contacts

    Find contacts by name, phone, email, tag, or opt-out status.

  • list_campaigns

    See recent broadcast campaigns with delivery counts.

  • get_campaign_analytics

    Full engagement: delivery, read, reply, opt-out, button-click rates + avg response time.

Write actions (3) — Claude asks before running

  • send_message

    Reply to a conversation via WhatsApp Cloud API.

  • resolve_conversation

    Mark a conversation as resolved.

  • tag_contact

    Add or remove tags on a contact.

Security & data handling

Org-scoped access

Every request Claude makes is filtered by your organization ID at the database layer. Cross-organization data leakage is not possible.

Hashed tokens

Access tokens are stored as SHA-256 hashes. Even if the database were compromised, the raw tokens couldn't be recovered.

Full audit log

Every tool Claude runs is recorded — name, arguments, result status, duration — visible in Settings → Integrations.

One-click revoke

Disconnect any AI at any time from Teambox Settings. Claude loses access immediately.

PKCE-only OAuth 2.1

The consent flow uses OAuth 2.1 with mandatory PKCE. Claude never sees or stores your Teambox password.

1-hour access tokens

Short-lived access tokens (60 minutes), rotated on every refresh. Compromise window is bounded.

What data is shared with Claude?

When you ask Claude to run a tool, Claude receives only the specific data that tool returns. For example, asking Claude to “list open conversations” sends Claude a list of conversation summaries — not your entire database.

✅ Claude can see

  • Conversations, messages, contacts you query
  • Campaign names and analytics
  • Tags, opt-out status, contact metadata

🚫 Claude cannot see

  • Data from other organizations
  • Your Teambox password or auth token
  • Meta / WhatsApp Business API credentials
  • Billing information or team management

Data sent through Claude is subject to Anthropic's data policies. Review Anthropic's privacy policy and our Connector Privacy Notice for how prompts and tool responses are handled.

Frequently asked questions

Is my data used to train Claude?▼
According to Anthropic's consumer terms, prompts and responses on claude.ai are not used to train models by default. If you use Claude API keys via the connector, the same applies. Review Anthropic's privacy policy for the current terms.
Can other people in my org connect their own Claude?▼
Yes. Each team member connects individually — their tokens are scoped to their own user and only see the data they'd normally have access to via Teambox permissions.
What if Claude tries to send a message I didn't want?▼
On Claude web and Desktop, write actions require confirmation before running. You'll see the exact message text before it's sent, and you can cancel. Every action is also logged in your audit trail.
How do I disconnect Claude?▼
Go to Settings → Integrations → Claude & AI Assistants and click Revoke on any connected app. Access is cut immediately.
Does the connector work with other MCP clients?▼
Yes — our endpoint is standards-compliant OAuth 2.1 + MCP. Any MCP-compatible client (Claude Desktop, custom apps, third-party AI tools) can connect using the same URL.
How long do access tokens last?▼
Access tokens live for 60 minutes. If Claude has offline_access scope, a refresh token can renew access for up to 60 days. You can revoke both at any time.

Need help?

Reach out at support@teambox.app and we'll walk you through setup on a call.