LinkedIn Ads Server

An MCP server that connects Claude (Code or Desktop) to the LinkedIn Ads API, giving you natural-language control over campaign management, audience targeting, creative uploads, analytics, and account auditing.

What it does

Category	Capabilities
Campaigns	Create, list, update campaign groups and campaigns
Audiences	Create/edit saved audiences, bulk geo-swap targeting
Creatives	Upload images and videos, create ad creatives
Analytics	Campaign and creative performance reports, account summaries
Auditing	10-point account audit (CTR decline, budget utilization, missing conversion tracking, etc.)
Bulk ops	Queue and execute batch campaign/group creation and updates

Best-practice enforcement is built in — audience expansion and audience network are disabled by default on every write operation.

Prerequisites

• Node.js 18+
• A LinkedIn Developer App with Advertising API access (apply here)
• OAuth scopes: r_ads, rw_ads, r_ads_reporting, r_basicprofile
• Your LinkedIn Ad Account ID

Quick start

git clone <this-repo-url>
cd linkedin-ads-mcp-server
npm install
cp .env.example .env
# Edit .env with your LinkedIn credentials
npm run build
npm start

You should see: LinkedIn Ads MCP server running — 34 tools registered

Connecting to Claude

Claude Code (CLI)

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "linkedin-ads": {
      "command": "node",
      "args": ["/path/to/linkedin-ads-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your_token",
        "LINKEDIN_AD_ACCOUNT_ID": "urn:li:sponsoredAccount:123456789"
      }
    }
  }
}

Claude Desktop

Add the same mcpServers block to %APPDATA%/Claude/claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).

Restart Claude after updating the config.

Usage

Once connected, just talk to Claude:

• "List my campaign groups"
• "Create a new campaign group called Q3 Brand Awareness"
• "Run a full account audit"
• "Show analytics for my top 5 campaigns this month"
• "Swap targeting from UK to US for all saved audiences"

To target a different ad account without restarting, pass it inline:

• "List campaigns for account urn:li:sponsoredAccount:987654321"

Full setup guide

See SETUP.md for detailed instructions covering:

1. Creating a LinkedIn Developer App
2. Generating OAuth tokens
3. Linking your ad account
4. Configuring Claude Code / Claude Desktop
5. Token refresh for production use
6. Upgrading to Standard API tier

Token expiration

Access tokens expire after 60 days. See SETUP.md Part 5 for the refresh flow.

License

MIT