# GTM CLI

> Query ZoomInfo's go-to-market data from your terminal. Install the GTM CLI, authenticate over OAuth, and pipe companies, contacts, intent, and research into your shell as JSON, CSV, or a table.

**Date:** 2026-06-22  
**Source:** https://gtm.ai/docs/cli

---

## What is the GTM CLI?

The GTM CLI is a command-line client for ZoomInfo's go-to-market data. A single binary, `gtm`, searches and enriches companies and contacts, pulls intent signals, scoops, and news, runs agentic research, and reads your GTM context. It connects to the same hosted endpoint as the [ZoomInfo MCP server](/docs/mcp), so the data, the credits, and the sign-in match what your AI tools already use. Results stream out as JSON, JSONL, CSV, YAML, or a table.

## Who is this for?

RevOps and data teams who script against ZoomInfo. Engineers who want deterministic, repeatable pulls with no model in the loop and no application to maintain. Anyone who wants to see real data in under a minute, before committing to a larger build.

## CLI, MCP, or API?

ZoomInfo exposes the same data three ways, through one backend. Reach for the CLI in the terminal: scripts, cron jobs, and one-off pulls. Reach for [MCP](/docs/mcp) when an AI agent should hold the data and decide what to fetch. Reach for the [API](/start-building) when you are building an application with its own retry and caching logic.

## Install

Homebrew is the shortest path on macOS and Linux.

```shell
brew install zoominfo/gtm-ai/gtm-ai-cli
```

On Windows, or anywhere you run Node, install the global npm package instead.

```shell
npm install -g @zoominfo/gtm-ai-cli
```

Prebuilt binaries for every platform are on the [releases page](https://github.com/Zoominfo/gtm-ai-cli/releases). Confirm the install:

```shell
gtm --version
```

## Authenticate

Sign-in is OAuth in your browser, with no client ID or secret to paste.

```shell
gtm auth login    # opens your browser, saves the token
gtm auth whoami   # show login status
gtm auth logout   # revoke and remove saved credentials
```

The token is written to `~/.config/gtm-ai/` at mode `0600`.

## Updating

Keep the CLI current with whichever package manager you installed it from.

```shell
brew upgrade gtm-ai-cli              # Homebrew
npm update -g @zoominfo/gtm-ai-cli   # npm
```

## Scripting and CI

The CLI runs unattended. Every command emits structured output and returns a proper exit code, so it drops into a cron job or a CI step with no interactive prompts.

```shell
# Fail a CI job if the search comes back empty
gtm companies search --industry software -f json | jq -e '.data | length > 0'
```

The repo also ships a [Claude Code skill](/marketplace/gtm-skills/gtm-ai-cli), so an agent can drive these same commands inside a larger workflow.

## Requirements

> **Subscription and credits**
>
> The data commands need a ZoomInfo subscription with bulk data credits enabled. Search and lookup are free. Enrichment and research draw down credits, and [Credits & Billing](/docs/mcp/credits) covers exactly how consumption works.

## Commands and guides

  - [Command reference](/docs/cli/commands): Every command, flag, output format, and credit note, with copy-paste examples for each.

  - [Getting started guide](/guides/gtm-ai-cli-getting-started): Install, authenticate, and run your first query.

  - [ZoomInfo MCP](/docs/mcp): The same data and sign-in, inside Claude, Codex, Cursor, ChatGPT, and other AI agents.

  - [Start building](/start-building): Compare the three paths.