Circleback CLI
Access Circleback data from the command line and give AI agents conversation context
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/cliThen log in to your Circleback account:
cb auth loginThis opens a browser window to log in. Once logged in, you are ready to go.
To log in with an API key instead:
cb auth login --api-keyAPI-key login links to Settings → API keys, verifies the key, and stores it locally on your device.
For stateless automation, set CIRCLEBACK_API_KEY instead of logging in:
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --jsonCIRCLEBACK_API_KEY takes precedence over stored credentials.
To sign out on this device:
cb auth logoutWhat you can do
The Circleback CLI has commands for searching, accessing, and updating data from your Circleback account like meetings, transcripts, calendar events, emails, people, companies, and more.
| Command | Description |
|---|---|
cb auth login | Log in to Circleback with your browser |
cb auth login --api-key | Log in with an API key |
cb auth logout | Sign out on this device |
cb update | Update CLI to the latest version |
cb meetings [search] | Find meetings by keyword, date range, tag, person, or company |
cb meetings read <ids...> | Read meeting details, notes, and action items (up to 50 meetings) |
cb meetings update <id> | Update a meeting |
cb meetings share <id> | Share a meeting with a person, team, workspace, or anyone with the link, or remove access |
cb transcripts <search> | Search transcripts for where something was said |
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 action-items create <title> | Create an action item, assigned to you unless you set --assignee |
cb action-items update <id> | Update an action item |
cb action-items delete <id> | Delete an action item |
cb calendar | Search upcoming and past calendar events, including event IDs, attendees, and meeting links |
cb calendar update <id> | Update a calendar event |
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 or domain to find their domain and related meetings |
cb teams | List your workspace and teams, with the IDs for sharing |
cb tags | List all tags in your workspace, useful for filtering meetings, transcripts, or action items |
cb tags create <name> | Create a tag, optionally with a description and color |
cb tags update <id> | Update a tag's name, description, or color |
cb tags delete <id> | Delete a tag and remove it from every meeting |
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 7Find meetings in a date range:
cb meetings search --from 2026-04-01 --to 2026-04-18Read the full details of a meeting:
cb meetings read abc123Read multiple meetings at once:
cb meetings read abc123 def456Share a meeting with people by email (comma-separated), or turn on view access for the link:
cb meetings share abc123 --email dana@acme.com,lee@acme.com --access Viewer --send-email
cb meetings share abc123 --link ViewerRemove someone's access, or turn off the link:
cb meetings share abc123 --profile 42 --access none
cb meetings share abc123 --link noneShare a meeting with a team, using its ID from cb teams:
cb meetings share abc123 --team 7 --access ViewerRename a meeting:
cb meetings update abc123 --name "Pricing sync"Transcripts
Search transcripts for something someone said:
cb transcripts search "pricing change"Get the full transcript of a meeting:
cb transcripts read abc123Get transcripts for multiple meetings:
cb transcripts read abc123 def456Action items
Find your incomplete action items:
cb action-items search --status pendingSearch action items by keyword:
cb action-items search "follow up"Find completed action items:
cb action-items search --status doneCreate an action item and assign it to someone (use cb people to find their ID). Without --assignee, it's assigned to you; use --assignee none to leave it unassigned:
cb action-items create "Send the renewal quote" --description "Include 2027 pricing" --assignee 42Link an action item to a meeting you can edit (use cb meetings to find its ID):
cb action-items create "Send the renewal quote" --meeting abc123Mark an action item done, or remove its assignee:
cb action-items update 1234 --status DONE
cb action-items update 1234 --assignee noneDelete an action item:
cb action-items delete 1234Calendar
See calendar events in a date range:
cb calendar search --from 2026-04-18 --to 2026-04-25Set prep notes on an upcoming event using its ID from cb calendar. They appear in your private notes when the meeting is recorded:
cb calendar update event123 --private-notes "Ask about the 2027 pricing"Emails
Search emails by keyword:
cb emails search "quarterly report"Search emails by participant:
cb emails search "participant:sarah@company.com"Search emails from a specific sender:
cb emails search "from:ceo@company.com"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 listCreate a tag, then set a meeting's tags by name or ID (comma-separated, replaces its current tags):
cb tags create Renewals --color emerald
cb meetings update abc123 --tags Renewals,7Rename a tag, or remove all of a meeting's tags:
cb tags update 7 --name "Q3 renewals"
cb meetings update abc123 --tags ""Support
Search Circleback support articles:
cb support search "recording in-person meetings"Write access
Creating, updating, and deleting needs write access. Browser logins from before v0.5.0 only granted read access, so run cb auth login again. Read-only API keys can't make changes, so use a read and write key from Settings → API keys.
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