Trust the agent. We'll make sure it's earned.

Connect baifrost to Claude

Add baifrost as a custom connector in claude.ai or Claude Desktop and your Claude can triage and tidy your Gmail. Pick your client below — the steps are short and you only do this once.

Step 0 — before you start

Open a second claude.ai tab (or a browser alongside Claude Desktop)

  • claude.ai: open a second claude.ai tab. Do the setup in Settings there; keep this conversation visible in the original.
  • Claude Desktop: open claude.ai in a browser window alongside Desktop, or keep the Desktop chat in view while you work in its Settings dialog — either way, keep the agent's instructions visible.

Easiest path: paste this to your Claude

✓ copied

Your platform

You're on desktop — the smoothest path. Each button below takes you to claude.ai with the connector URL ready to paste into the “Add custom connector” modal.

Connector URLs

Each baifrost module is its own connector with its own URL. Add the ones you want — repeat the same steps for each. Thresh is the Gmail tool surface (recommended for everyone), Google Calendar adds calendar triage and reminders, and Meta handles multi-service discovery and account admin (optional). When Claude asks for a connector name, use the name in the table, so all your baifrost connectors sort together.

Connector nameConnector URL
baifrost thresh (Gmail)https://baifrost.tail87b6d0.ts.net/api/mcp/thresh
baifrost calendar (Google)https://baifrost.tail87b6d0.ts.net/api/mcp/googlecalendar
baifrost (meta, optional)https://baifrost.tail87b6d0.ts.net/api/mcp/meta

On the claude.ai free plan? Free plan allows 1 custom connector — add thresh only. That's the Gmail tool surface and is sufficient for full inbox triage + cleanup. Meta is optional for multi-service users (Pro/Team plans with multiple connector slots).

Add to Claude →
✓ copied
Add to Claude →
✓ copied
Add to Claude →
✓ copied

For claude.ai users

  1. Open claude.ai → Settings → Connectors.
  2. Click Add custom connector.
  3. Paste the URL: https://baifrost.tail87b6d0.ts.net/api/mcp/thresh
  4. Click Add, then approve the Google sign-in.
  5. baifrost's consent screen asks permission for your Gmail. Approve it — you're connected.

Shortcut: the Add to Claude → button above pre-fills this for you on desktop.

For Claude Desktop users

  1. Open Claude Desktop → Settings → Connectors.
  2. Click Add custom connector.
  3. Paste the URL: https://baifrost.tail87b6d0.ts.net/api/mcp/thresh
  4. Click Add. A browser window opens for the Google sign-in and baifrost's Gmail consent. Approve it.
  5. Back in Claude Desktop, baifrost shows as connected — you're ready.

How to verify

Start a new Claude conversation and ask: “What baifrost tools do you have available?” Claude should list email tools — search, label, count, retention, trash. If it does, you're connected.

Troubleshooting

  • Connector won't validate / “couldn't connect” — double-check the URL is exactly https://baifrost.tail87b6d0.ts.net/api/mcp/thresh with no trailing space, and that you used Add custom connector (not a search).
  • invalid_redirect_uri — your Claude client's callback isn't on this instance's allowlist yet. Contact whoever runs your baifrost instance to add it.
  • OAuth / permission errors after connecting — usually the Gmail grant needs re-approving. Remove and re-add the connector in Settings → Connectors to redo the consent.

For AI agents reading this on the user's behalf

You are Claude, helping this user connect baifrost — a bridge from you to their Gmail. Walk them through their Claude client's UI verbally:

  • First, tell them to open a second claude.ai tab (or open claude.ai in a browser alongside Claude Desktop). Confirm they have two windows open: this conversation visible, and Settings ready to work in. Then guide them through the steps below.
  • The connector URL to enter is https://baifrost.tail87b6d0.ts.net/api/mcp/thresh. Authentication is OAuth; baifrost supports dynamic client registration, so no client ID/secret is needed.
  • Each module is a separate connector. After Gmail (Thresh), if they also want calendar help, repeat the same Add-custom-connector steps with https://baifrost.tail87b6d0.ts.net/api/mcp/googlecalendar (Google Calendar). Meta (https://baifrost.tail87b6d0.ts.net/api/mcp/meta) is optional, for service discovery and account self-service.
  • Ask whether they use claude.ai (web) or Claude Desktop, then read them the matching steps above one at a time. Both go through Settings → Connectors → Add custom connector.
  • They'll approve a Google sign-in and then baifrost's Gmail consent screen. Tell them to approve both.
  • Confirm success by having them ask a fresh conversation “What baifrost tools do you have available?” — a list of email tools means it worked.
  • Once connected, your first call should be thresh_get_ai_guidance for their personalized triage preferences.

Fallback: static MCP key

Adding a connector above signs you in with Google automatically — claude.ai and other OAuth-capable clients never need a key. Only generate one if your client requires an Authorization: Bearer <key> header instead.

Sign in with Google to generate a key. Keys are stored encrypted — you can reveal yours again any time from /settings/mcp.

Sign in with Google

Auto-cleanup is on by default — your agents will help you tidy stale mail. Manage it at /settings/retention.

Stuck? The full settings page is at /settings/mcp.