Echo CLI

The Echo CLI lets you search meetings, configure managed agents, and use every tool available through your Echo MCP connection from your terminal. Or let your agent do it for you.

Agent Install

Paste this into Claude or Codex and let it set up the CLI for you.

I want to set up Echo CLI so you can use it from this agent session.

Please do the following:

1. Install Echo CLI by running:
   curl -fsSL https://echoecho.ai/install.sh | sh

2. Log me in by running echo-cli login. Show me the sign-in URL from the command output so I can open it in my browser and finish the login manually if needed. Wait for me to finish the browser login before continuing.

3. Verify the install by running echo-cli --help.

4. Verify the authenticated connection by running echo-cli status.

5. After the CLI works, ask me whether to install the Echo skill for Claude or Codex. Then install it for the agent I choose using echo-cli skills install <claude|codex>. If the exact command is unclear, run echo-cli skills --help and follow the CLI's instructions.

6. Give me a short overview of what you can now do with the CLI:
   - search cloud-synced meetings with echo-cli meetings
   - search spoken content with echo-cli transcripts
   - read a meeting or transcript by ID with the matching read command
   - discover every available MCP tool with echo-cli tools list, inspect its current input schema with echo-cli tools inspect TOOL, and call it with echo-cli tools call TOOL --input FILE
   - use --json when you need structured output for analysis or another tool
   - if my account is in the Toolbox pilot, connect other MCP servers with echo-cli toolbox add and see who can reach them with echo-cli toolbox clients; grant and revoke changes to other clients print a link I approve on my Toolbox page

Start by explaining the commands you plan to run, then run them.

Manual Install

Prefer to set things up yourself? Use this manual flow instead of the Agent Install flow above.

Requirements

An Echo account
macOS or Linux
Node.js 22.3 or newer

Install

curl -fsSL https://echoecho.ai/install.sh | sh

Usage

echo-cli
echo-cli login
echo-cli status
echo-cli tools list
echo-cli tools inspect cma_agent_configure
echo-cli meetings "product review" --last 30
echo-cli meetings read MEETING_ID
echo-cli transcripts "pricing discussion"
echo-cli transcripts read MEETING_ID
echo-cli toolbox add https://mcp.linear.app/mcp
echo-cli toolbox connectors
echo-cli toolbox clients
echo-cli toolbox grant CLIENT_KEY CONNECTOR_ID read_only
echo-cli toolbox revoke CLIENT_KEY
echo-cli logout

Every MCP tool

echo-cli tools list discovers the live tools available to your account and this CLI's grants, including managed agents and connected Toolbox tools. New server tools appear without a CLI update. Meeting and Toolbox commands remain convenient shortcuts through the same MCP connection.

Inspect a tool before calling it: calls can change data. The server supplies the current input schema and enforces authorization, validation, and trigger permissions. For example, inspect the managed-agent configuration tool, save your requested change as a JSON object in change.json, then call it:

echo-cli tools inspect cma_agent_configure --json
echo-cli tools call cma_agent_configure --input change.json --json
cat change.json | echo-cli tools call cma_agent_configure --input - --json

Omitting --input sends {}. Use a file or --input - for stdin to keep private arguments out of shell history and process listings. tools call --json returns the complete MCP result, including content and any structuredContent. Successful results go to stdout; failures go to stderr and exit nonzero. With --json, tool refusals preserve their complete MCP error result on stderr. Calls never prompt or automatically retry mutations. Only echo-cli login starts browser sign-in. Use --timeout SECONDS to change the default 60-second timeout per request. Command help works without a connection.

Toolbox

Accounts in the Toolbox pilot can connect other MCP servers (Linear, Notion, Conductor, any server that implements standard MCP authorization) to their Echo Toolbox once, then give every agent the single Echo MCP. Each connected client sees the upstream tools it was granted, prefixed with the connector's slug (linear__create_issue). toolbox add prints an authorization link to open in your browser; toolbox clients shows every connected client and what it may reach. Agents propose, you grant: toolbox grant and toolbox revoke apply at once only when this CLI narrows or disconnects itself; any other change prints a link to your Toolbox page, where you press Allow within ten minutes.

Tips

Use --json with data commands for raw JSON output, which is useful for piping to jq or handing results to an agent.
Re-run the install command to update to the latest version.

Uninstall

Remove this machine's saved CLI credentials:

echo-cli logout

Then remove the CLI's package directory and executable:

curl -fsSL https://echoecho.ai/install.sh | sh -s -- --uninstall

Questions or issues? Send us feedback!