Spotify Ads API

Spotify Ads Agentic Tools

A Codex, Claude Code, and Antigravity CLI plugin package that lets you manage Spotify advertising campaigns through natural language. Create campaigns, target audiences, launch ads, and pull performance reports — all by describing what you want in plain English.

Check out our post on the Spotify Engineering Blog.

Prerequisites

• Codex, Claude Code CLI, or Antigravity CLI
• A Spotify Developer account with an ads-enabled app
• A Spotify Ads ad account ID
• Python 3.8+ or uv (required for the secure configuration helpers). On Windows, ensure python or py is in your PATH.
• Git for Windows (Windows only; provides Git Bash, which the token refresh hook requires)
• jq (recommended on Windows for richer hook output; the token refresh hook works without it but produces minimal JSON)

Install

Claude Code

claude plugin i spotify-ads-api

The plugin is installed from the Official Anthropic marketplace, which has auto-update enabled by default. Claude Code checks for plugin updates in the background after each session starts and applies them automatically. New versions take effect on your next launch (or run /reload-plugins to pick them up in the current session).

To use this repository as a custom marketplace in the Claude UI, choose Add marketplace, enter spotify/ads-agentic-tools or https://github.com/spotify/ads-agentic-tools, and select Sync. Then install Spotify Ads API from that marketplace. The Claude marketplace intentionally uses the repository-relative plugin source "./"; Git-based marketplace installs clone the whole repository and resolve that path from the repository root.

If you have auto-update disabled for the Official Anthropic marketplace, you will need to update the plugin manually. See the Anthropic instructions on Discover and install plugins for instructions on managing marketplace updates.