# Circleback CLI (/docs/support/platform/circleback-cli) 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](https://www.npmjs.com/package/@circleback/cli): ``` npm install -g @circleback/cli ``` Then log in to your Circleback account: ``` cb auth login ``` This 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-key ``` API-key login links to **[Settings → API keys](https://circleback.ai/settings?tab=api-access)**, 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 --json ``` `CIRCLEBACK_API_KEY` takes precedence over stored credentials. To sign out on this device: ``` cb auth logout ``` ## 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 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 transcripts read ` | 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 ` | Look up people by name to see their profile and interaction history across meetings | | `cb companies ` | Look up companies by name or domain 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 Vd6Pz8WqLm3xY2cRhTn7K ``` Read multiple meetings at once: ``` cb meetings read Vd6Pz8WqLm3xY2cRhTn7K 12345 ``` ### Transcripts Search transcripts for something someone said: ``` cb transcripts search "pricing change" ``` Get the full transcript of a meeting: ``` cb transcripts read Vd6Pz8WqLm3xY2cRhTn7K ``` Get transcripts for multiple meetings: ``` cb transcripts read Vd6Pz8WqLm3xY2cRhTn7K 12345 ``` ### 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: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 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 ```