LinkedIn Ads MCP Server

Production-grade MCP server for LinkedIn Campaign Manager API. Enables Claude to manage LinkedIn ad accounts, campaigns, ad sets, and creatives with full read/write support.

Features:

• 65+ production-tested tools
• Multi-account management (multiple LinkedIn ad accounts)
• Campaign, ad group, creative, and targeting management
• Targeting: demographics, interests, job titles, locations, behaviors
• Budget & bid optimization
• Campaign cloning & templating
• Safe create/update operations (validation first)

Stats:

• ⭐ Production-proven: 65+ active campaigns under management
• 📊 Multi-client: Flowspace, Forcepoint, Neon One
• 🔄 CTR accuracy: Uses landingPageClicks (not total clicks with engagement)
• ✅ Full test coverage: 40+ contract tests

Installation

npm install mcp-linkedin-ads

Configuration

1. Get OAuth credentials:

   • Go to LinkedIn Developer Portal
   • Create a new app with "Sign In with LinkedIn" + "Marketing Developer Platform"
   • Scopes: r_ads, rw_ads, w_member_social, r_organization_social, w_organization_social

2. Create config.json:

   cp config.example.json config.json
   

3. Fill in your credentials:

   {
     "oauth": {
       "client_id": "YOUR_CLIENT_ID",
       "client_secret": "YOUR_CLIENT_SECRET"
     },
     "clients": {
       "default": {
         "account_id": "YOUR_AD_ACCOUNT_ID",
         "name": "My Account"
       }
     }
   }
   

4. Set environment variables (recommended for production):

   export LINKEDIN_CLIENT_ID="your_client_id"
   export LINKEDIN_CLIENT_SECRET="your_client_secret"
   export LINKEDIN_AD_ACCOUNT_ID="your_account_id"
   

Usage

Start the server

npm start

Use with Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "linkedin-ads": {
      "type": "http",
      "url": "http://localhost:3001"
    }
  }
}

Example API Calls

// Get client context
get_ads_client_context({ working_directory: "/path/to/project" })

// List campaigns
get_campaigns({ account_id: "511664399" })

// Create campaign
create_campaign({
  name: "Q2 B2B Campaign",
  objective: "LEAD_GENERATION",
  status: "PAUSED"
})

// Get campaign insights
get_insights({
  object_id: "campaign_123",
  time_range: "last_7d"
})

Key Data Conventions

CTR Calculation

• Always use landingPageClicks (LP clicks), NOT clicks (total clicks)
• Total clicks include social engagement (likes, comments, shares) which inflates CTR
• This is critical for accurate campaign analysis

Campaign Status

• DRAFT — Not yet active
• ACTIVE — Actively serving
• PAUSED — Paused manually
• ARCHIVED — Historical record

Audience Targeting

• Flexible targeting: flexible_spec array (OR logic between items)
• Exclude targeting: exclude_spec array
• Job titles, seniority levels, functions, locations all supported

CLI Tools

npm run dev                 # Run in dev mode (tsx)
npm run build             # Compile TypeScript
npm test                  # Run contract tests

Architecture

Files:

• src/index.ts — MCP server, OAuth flow, tool handlers
• src/tools.ts — Tool schema definitions
• src/errors.ts — Error handling & classification
• config.json — Credent

... View full README on GitHub