LinkedIn Ads MCP 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

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