Adscriptly CLI

AI-powered CLI for managing Google Ads from the terminal.

    _       _               _       _   _
   / \   __| |___  ___ _ __(_)_ __ | |_| |_   _
  / _ \ / _` / __|/ __| '__| | '_ \| __| | | | |
 / ___ \ (_| \__ \ (__| |  | | |_) | |_| | |_| |
/_/   \_\__,_|___/\___|_|  |_| .__/ \__|_|\__, |
                              |_|          |___/

Installation

npm

npm install -g adscriptly

curl

curl -fsSL https://adscriptly.com/install | bash

Homebrew

brew tap adscriptly/tap
brew install adscriptly

Quick Start

# 1. Authenticate via browser
adscriptly login

# 2. Start AI chat (default command)
adscriptly

Commands

| Command | Description | |---------|-------------| | adscriptly login | Authenticate via browser OAuth | | adscriptly logout | Sign out and remove token | | adscriptly | Start interactive AI chat (default) | | adscriptly config | View/manage configuration |

Chat Modes

| Mode | Shortcut | Description | |------|----------|-------------| | /plan | shift+tab | Describe changes without executing (default, safe) | | /execute | shift+tab | Require confirmation (y/n) before changes | | /yolo | shift+tab | Execute all tools immediately |

Workflows

| Command | Description | |---------|-------------| | /audit | Full account optimization audit | | /diagnose | Performance troubleshooting | | /scale | Growth planning and ceiling analysis | | /report | Generate formatted report | | /choose-account | Switch Google Ads account | | /account-list | List connected accounts | | /new | Start new conversation |

MCP Server (Claude Desktop)

Adscriptly includes an MCP server that exposes Google Ads tools to Claude Desktop.

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "adscriptly": {
      "command": "adscriptly-mcp-server"
    }
  }
}

You must run adscriptly login first to authenticate.

Requirements

• Node.js >= 18
• An Adscriptly account with connected Google Ads

Links

• Adscriptly App
• Documentation