Connect your AI agent

Toldbird Pro includes a remote MCP server. An AI agent that already knows your work can fill in your Toldbird setup for you, and you approve what it writes.

What an agent can do

  • Write who you are for Work, Personal and Job search, with a default coaching mode for each.
  • Create Contexts: one project, deal or role, with its notes, and for job search your CV and the job description.
  • Create Topics and add documents to them.
  • Plan a meeting that is not on any calendar, with its time, Context, mode and goal. Toldbird asks you two minutes before it starts. Nothing records until you click Start.

An agent cannot read your transcripts, recaps, notes, chat or calendar.

Set it up

  1. In Toldbird, open Settings › General › Connect an agent.

  2. Name the token (for example “Laptop agent”), choose how long it lasts, and click Create.

  3. Copy the setup line Toldbird shows. Toldbird shows the token only once. For Claude Code it looks like this:

    claude mcp add --transport http toldbird https://api.toldbird.com/mcp --header "Authorization: Bearer tbat_…"
    

    Other MCP clients need the same two things: the server URL https://api.toldbird.com/mcp and the header Authorization: Bearer <your token>.

  4. Ask your agent to set up Toldbird, for example: “Use Toldbird to set up my work profile and a Context for Project X, then plan a 30-minute tech sync tomorrow at 10.”

You approve what it writes

What an agent writes about you shows in Settings › Who you are as items to review. Nothing an agent writes reaches a meeting until you click Approve. A planned meeting from an agent is marked From your agent. You can approve it in three places:

  • Before the meeting: click Approve & start on the meeting in the menu bar, or in the start notification.
  • During the meeting: if you started without approving, click Approve & use notes on the warning in the Toldbird window. The notes are used from then on.
  • Any time: the menu bar shows how many items from your agent wait for review. Briefing › Planned and Settings list them with Approve and Discard.

Approving a planned meeting also approves the Context text it uses. Topic documents and custom modes an agent adds take effect at once; you can delete them in Settings.

Revoke a token

Settings › General › Connect an agent lists each token with its last use and recent writes. Click Revoke and it stops working on the next request. Tokens stop working while your plan is not Pro, and work again when Pro resumes.

Questions: supporttoldbird.com