Setup guide · Claude Code plugin

X Ads Claude Code Plugin

Install the NotFair plugin in Claude Code in under 2 minutes. Claude reads your X (Twitter) ad accounts — campaigns, line items, promoted Tweets, and analytics — in real time and helps you diagnose, optimize, and manage them right from your terminal.

Free · No credit card · 2-minute setup

How to install

Add NotFair to Claude Code in 4 steps

Free · No credit card · No API key to copy

Open Claude Code

Open a terminal and start Claude Code. If you do not have it installed, follow Anthropic's install guide first.

Install the NotFair plugin

In Claude Code, run these slash commands to register the NotFair marketplace, install the NotFair plugin, and reload plugins. NotFair ships with pre-made paid-ads and SEO skills that teach Claude how to audit and optimize your campaigns.

/plugin marketplace add nowork-studio/NotFair

/plugin install notfair@nowork-studio

/reload-plugins

Run /x-ads

Run /x-ads in Claude Code. It will open your browser to sign in and connect NotFair. If the command does not appear, restart Claude Code first.

/x-ads

Important: sign in with the same Google account you use on NotFair. Otherwise Claude Code will connect to an empty account and will not see your X Ads data.

Ask Claude about your ads

Try a prompt like “Audit my connected X (Twitter) ad account and tell me the 3 biggest optimization opportunities.” Claude will call NotFair tools to read your account and respond with specific, data-backed insights.

Ready to install the plugin?

Run three slash commands in Claude Code, then /ads to sign in and link X. Setup takes under 2 minutes — no API key.

Open in-app setup Or use the Claude Web / Cowork connector

FAQ — NotFair for Claude Code (X Ads)

Everything you need to know about installing and using the NotFair plugin inside Claude Code for X Ads.

What is the NotFair Claude Code plugin for X Ads?

It's the same NotFair Claude Code plugin that gives Claude Code live access to your ad accounts — once installed, /ads connects Claude to your X (Twitter) campaigns, line items, promoted Tweets, and analytics. You diagnose issues, recommend fixes, and optimize through chat in your terminal.

How is this different from the Claude Connector?

The plugin is for Claude Code — Anthropic's terminal-based coding agent. The Claude Connector is for Claude.ai Web and Claude Cowork. Both use the same NotFair backend; the install flow is just different.

How long does setup take?

Under 2 minutes. Run three slash commands inside Claude Code to add the marketplace, install the plugin, and reload, then run /ads — Claude opens your browser to sign in via X's OAuth flow. No API key to copy.

Do I need to write any code?

No. Setup is entirely slash-command driven inside Claude Code. You'll paste a few commands — no JSON config edits, no environment variables, no scripts, no API keys.

Is the plugin free?

Yes. Installing the NotFair plugin and using it for X Ads is free with no credit card. Paid plans unlock higher usage limits and team features.

Can Claude actually change my X ad accounts through the plugin?

Only with your explicit approval. Claude can propose pausing campaigns or line items, adjusting budgets, or renaming entities — but every write action is shown to you first and requires confirmation. Read access is unrestricted; write access is gated.

Can I use the same plugin across platforms?

Yes. The NotFair plugin ships skills for every supported platform. Once installed, /ads can read whichever platforms you've linked. Switch between them via the navbar account dropdown in the NotFair web app.

Related guides

Explore the rest of the NotFair + Claude workflow.