Skip to main content

Circleback CLI

Access Circleback data from the command line and give AI agents conversation context

Updated today

Access everything from the command line, or give your AI agents the conversation context they need to get things done. Have OpenClaw follow up on action items from this morning's standup. Let Claude Code draft a spec based on your last product review.

Setup

Get started by installing the Circleback CLI:

npm install -g @circleback/cli

Then authenticate with your Circleback account:

circleback login

This opens a browser window to log in. Once authenticated, you are ready to go.

What you can do

The Circleback CLI has commands for searching and accessing data from your Circleback account like meetings, transcripts, calendar events, emails, people, companies, and more.

Command

Description

cb meetings [search]

Find meetings by keyword, date range, tag, attendee, or domain

cb meetings read <ids...>

Get detailed information for specific meetings, including notes, attendees, action items, insights, tags, and duration

cb transcripts <search>

Search across all meeting transcripts to find where something was mentioned

cb transcripts read <ids...>

Get the full transcript for one or more meetings, with speaker labels and timestamps

cb action-items [search]

Find action items by keyword, status (pending or done), assignee, tag, or date range

cb calendar

Search upcoming and past calendar events, including attendees and meeting links

cb emails [search]

Search connected email accounts for threads by keyword, sender, recipient, or date range

cb people <names...>

Look up people by name to see their profile and interaction history across meetings

cb companies <terms...>

Look up companies by name to find their domain and related meetings

cb tags

List all tags in your workspace, useful for filtering meetings, transcripts, or action items

cb support [search]

Search Circleback support documentation for help and how-to guides

Examples

Meetings

Find meetings about a specific topic:

cb meetings search "product review"

Find meetings from the last 7 days:

cb meetings search --last 7

Find meetings in a date range:

cb meetings search --from 2026-04-01 --to 2026-04-18

Read the full details of a meeting:

cb meetings read 12345

Read multiple meetings at once:

cb meetings read 12345 67890

Transcripts

Search transcripts for something someone said:

cb transcripts search "pricing change"

Get the full transcript of a meeting:

cb transcripts read 12345

Get transcripts for multiple meetings:

cb transcripts read 12345 67890

Action items

Find your incomplete action items:

cb action-items search --status pending

Search action items by keyword:

cb action-items search "follow up"

Find completed action items:

cb action-items search --status done

Calendar

See calendar events in a date range:

cb calendar search --from 2026-04-18 --to 2026-04-25

Emails

Search emails by keyword:

cb emails search "quarterly report"

Search emails by participant:

cb emails search "participant:[email protected]"

Search emails from a specific sender:

cb emails search "from:[email protected]"

Search emails in a date range:

cb emails search "project update after:2026-01-01 before:2026-04-01"

People

Look up a person:

cb people search "Sarah Kerrigan"

Companies

Look up a company:

cb companies search "Acme"

Tags

List all tags:

cb tags list

Support

Search Circleback support articles:

cb support search "recording in-person meetings"

Options

All commands support --json for raw JSON output, which is useful for scripting, piping into other tools, or feeding data to AI agents.

cb meetings search "standup" --last 7 --json
Did this answer your question?