Topcalls CLI
Run your Topcalls tools from the terminal, and add Topcalls to Claude Code, Cursor, Codex and VS Code with one command.
Key takeaways
- The Topcalls CLI is the npm package @topcalls/cli. Install it with npm install -g @topcalls/cli on Node.js 20 or newer.
- topcalls login opens Topcalls in your browser to sign in and pick the account. The Topcalls CLI never asks for your password.
- topcalls agent setup adds the Topcalls MCP server to Claude Code, Cursor, Codex and VS Code, and asks before it changes any file.
- Every Topcalls tool your account can use is a command of the Topcalls CLI, and topcalls tools lists them.
- A Topcalls CLI command that changes data shows the account and the arguments, then asks before it runs.
Install the Topcalls CLI
npm install -g @topcalls/cliThe package is @topcalls/cli, with the scope. A package named plain topcalls or topcalls-cli isn't ours. Then run topcalls login, and topcalls agent setup to connect your coding agents. What each tool does, and what stays under your control, is in the MCP documentation.
Topcalls CLI commands
| Command | What it does |
|---|---|
| topcalls login | Opens Topcalls in your browser to sign in and pick the account. |
| topcalls whoami | Shows the account the connection uses. |
| topcalls agent setup | Adds the Topcalls MCP server to Claude Code, Cursor, Codex and VS Code on this computer, after asking. |
| topcalls tools | Lists every tool your account can use, and whether it reads or writes. |
| topcalls <tool> --help | Shows the flags of one tool, for example topcalls list_campaigns --help. |
| topcalls logout | Ends the connection in Topcalls and removes it from this computer. |
Capabilities
What's under the hood
Every feature is designed to work together, giving you a complete system out of the box.
Sign in in your browser
topcalls login opens Topcalls to sign in and pick the account. The CLI never asks for your password and never takes a token on the command line.
Every tool is a command
The CLI asks Topcalls for the tool list each time, so new tools show up without an update. topcalls tools lists them.
It asks before changes
A command that changes data shows the account and the arguments, then asks before it runs. Add --yes to skip the question in a script.
Sets up your coding agents
topcalls agent setup adds the Topcalls MCP server to Claude Code, Cursor, Codex and VS Code. It shows what it will change, asks first and keeps a backup of each file.
Same rules as any AI app
The CLI goes through the same role checks, limits and activity log as any AI app connected to Topcalls. A read-only connection sees only the tools that read.
Quiet by design
The CLI talks only to Topcalls, over HTTPS. It sends no analytics and doesn't check for updates.
Frequently asked questions
How do I install the Topcalls CLI?
Run npm install -g @topcalls/cli. It needs Node.js 20 or newer. Then run topcalls login to sign in and topcalls whoami to check the account.
Where does the Topcalls CLI keep my sign-in?
In ~/.config/topcalls/credentials.json, readable only by you. On macOS and Linux the CLI refuses a credentials file that other users can read. topcalls logout ends the connection and removes the file.
Which AI apps can topcalls agent setup connect?
Claude Code, Cursor, Codex and VS Code, when they're installed on your computer. It writes no password or token. Claude Code, Cursor and VS Code ask you to sign in to Topcalls the first time they use a Topcalls tool; for Codex, run codex mcp login topcalls once.
Can I use the Topcalls CLI in a script?
Yes. Every result is printed as JSON, and the exit code says what happened: 0 when done, 1 for an error or a no, 2 for a wrong command, 3 when you're not logged in. A command that changes data needs --yes when there is no terminal to answer in.