MCP Servers · nowork-studio

NotFair

NotFair is an open-source Claude Code plugin that integrates Google Ads, Meta Ads, and SEO analysis directly into AI workflows. It audits marketing accounts for wasted spend, ranking issues, and creative fatigue, then executes fixes—from pausing keywords to rewriting meta tags—with full reversibility.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/nowork-studio/NotFair

3.1k

GitHub stars

374

Forks

TypeScript

Primary language

MIT

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	nowork-studio/NotFair
Owner	nowork-studio
Primary language	TypeScript
License	MIT — OSI-approved
Stars	3.1k
Forks	374
Open issues	5
Latest release	Unknown
Last updated	2026-07-08
Source	https://github.com/nowork-studio/NotFair

What NotFair is

TypeScript-based plugin exposing marketing APIs (Google Search Console, Google Ads, Meta Ads) as Claude Code skills. Includes a companion web app at notfair.co, an optional local CMO agent portal (notfair-cmo), and state management via ~/.toprank/ directory. Uses OS keychain for token storage and MCP servers for platform auth.

Quickstart

Get the NotFair source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/nowork-studio/NotFair.git2cd NotFair3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Continuous Ad Account Auditing

Weekly or on-demand audits of Google Ads and Meta Ads campaigns to identify wasted spend, low-performing keywords, and audience saturation. Claude Code can invoke audits, summarize findings, and execute reversible fixes (pause keywords, add negatives, adjust bids).

SEO Technical & Content Diagnostics

Analyze Search Console traffic data and crawl technical issues (duplicate URLs, keyword cannibalization, low-CTR pages). Surfaces 30-day prioritized fixes and can rewrite meta tags, headings, and add structured data when repo access is granted.

Embedded Marketing Agents via CMO Portal

NotFair CMO runs specialist agents (CMO, Google Ads, Meta Ads, SEO, X Ads) locally in a web UI. Enables team task delegation, kanban workflows, approval gates for spend/changes, and scheduled recurring audits—all without cloud infrastructure.

Implementation considerations

Installation is plugin marketplace–based (30 seconds claimed). First use of Google Ads or Meta Ads MCP triggers browser login; tokens stored in OS keychain—verify keychain availability and security posture for your OS.
State and audit history stored locally in ~/.toprank/ directory. Ensure sufficient disk space and backup strategy if audit logs are business-critical. Intentionally not migrated on plugin rename (toprank → notfair) for v0.24.0+.
Web app companion (notfair.co) requires separate sign-in; CLI and web share the same engine. Confirm data sync behavior, API rate limits, and quota management between CLI and web before heavy automation.
CMO portal (notfair-cmo) requires Node 20+ and runs on http://127.0.0.1:3327 locally. Network isolation and port conflicts should be evaluated; approval workflows and cron scheduler are built-in but require operational testing.
Reversibility is claimed ('7 days') for certain changes (bid adjustments, pauses). Verify rollback windows and scope with NotFair team; some changes (structural edits to pages, negative keywords) may have different or no rollback paths.

When to avoid it — and what to weigh

No Claude Code or Codex Access — NotFair requires Claude Code (recommended) or Codex CLI as the host environment. Cannot run standalone or in other agent frameworks without manual adaptation.
Strict Data Residency Requirements — Plugin connects to notfair.co web service for authentication and audit data processing. Unknown where data is stored or processed; organizations with strict on-premises or data residency mandates require review before use.
Hands-Off, Approval-Only Workflows — Plugin is designed for autonomous or semi-autonomous execution (Claude changes bids, pauses keywords, rewrites pages). Not suitable if your compliance model requires manual review of every operational change before execution.
Multi-Account / Enterprise SSO at Scale — Installation and auth (OS keychain storage, browser tab login flow) is designed for individual or small team use. Scaling across departments or enterprises with centralized identity and access control requires engineering effort.

License & commercial use

MIT License. Permits commercial use, modification, and distribution with attribution and inclusion of license notice. No patent indemnification or trademark grants in MIT. Review applies to company's legal obligations under MIT; no restrictions on closed-source deployment of integrations.

MIT License permits commercial use of the plugin code itself. However, using Google Ads and Meta Ads APIs commercially requires compliance with those platforms' own terms of service; NotFair does not appear to provide legal indemnification or guarantee of compliance. Companion web app (notfair.co) and CMO portal (notfair-cmo npm package) are open-source but backed by NotFair company; confirm whether free tier is indefinite or whether production commercial use requires a paid plan or support agreement. Requires review before deploying to production in a revenue-generating workflow.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	High

Security considerations

Plugin stores Google Ads, Meta Ads, and Search Console OAuth tokens in OS keychain. Keychain security depends on OS (macOS Keychain, Linux secret-service, Windows Credential Manager) and local access controls. Companion web service (notfair.co) involved in auth flow (browser tab login); token transmission and storage on notfair.co servers not documented. Code execution model (Claude Code invoking skills) means AI model has access to ad account credentials—review your threat model for AI-assisted account management. No mention of audit logging, encryption at rest, or data retention policy. Requires review before sensitive financial or account data is exposed.

Alternatives to consider

Zapier + Native Google Ads / Meta Ads Integrations

Provides automation and auditing without AI, more mature integration ecosystem, and built-in multi-account support. Trade-off: less intelligent analysis and no code-level integration.

SuperMetrics or Adverity (BI layer + API)

Dedicated data warehouse for ads/SEO metrics, dashboarding, and custom automations. No AI agent; more suitable for organizations wanting centralized reporting over autonomous optimization.

Build your own plugin using OpenAI Assistants API and direct API integration. Full control, no dependency on NotFair or Claude Code, but requires significant engineering.

Software development agency

Build on NotFair with DEV.co software developers

If you use Claude Code and need autonomous Google Ads or Meta Ads optimization, NotFair integrates directly. Verify data handling, auth security, and notfair.co service availability before production deployment.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

google-meta-ads-ga4-mcp notifiarr claude-plugins-official

Related on DEV.co

Explore the category and the services that help you build with it.

MCP Servers AI Application Development API Development Cloud Deployment Talk to DEV.co

NotFair FAQ

Can I use NotFair without Claude Code?

No. NotFair is a Claude Code plugin. Manual install (settings.json) is still Claude Code–dependent. CMO portal requires Claude Code or Codex CLI as the harness. Standalone or OpenAI GPT integration is not supported.

Where are my Google Ads and Meta Ads credentials stored?

OAuth tokens are stored in your OS keychain (macOS Keychain, Linux secret-service, Windows Credential Manager). Credentials are not persisted in the plugin code or .toprank/ state directory. The notfair.co web service is involved in the auth flow (browser login), but the extent of token caching or storage on their servers is not documented and requires review.

What happens if notfair.co goes down?

Unknown. The plugin connects to notfair.co for authentication and audit processing. No failover, offline mode, or cache strategy is documented. CLI and CMO portal likely cannot function if the service is unavailable.

Can I pause, revert, or undo changes made by the plugin?

Plugin claims changes are 'reversible within 7 days' for some operations (bid changes, pauses). Scope and mechanism of rollback are not fully documented. Page-level changes (meta tag rewrites, heading fixes) may have different or no undo path. Test in a non-production environment first.

Custom software development services

DEV.co helps companies turn open-source tools like NotFair into production software. Our software development services cover the full lifecycle — architecture, web development, integration, and maintenance — delivered by software developers and web developers who ship. Engage our software development agency to implement or customize it for your mcp servers stack.

Evaluate NotFair for Your AI-Driven Marketing Workflow

Talk to DEV.co Schedule a Consultation