meta-ads-mcp-server

gabe-almeida/meta-ads-mcp-server

3.1

If you are the rightful owner of meta-ads-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for managing Meta advertising campaigns programmatically through AI assistants.

Meta Ads MCP Server

A Model Context Protocol (MCP) server for programmatic management of Meta (Facebook/Instagram) advertising campaigns through AI assistants.

Features

  • Campaign Management: Create, read, update, and delete advertising campaigns
  • Ad Set Management: Configure targeting, budgets, and optimization goals
  • Creative Management: Upload media and create ad creatives
  • Analytics & Insights: Retrieve performance data with breakdowns and custom metrics
  • Audience Management: Create and manage custom, lookalike, and saved audiences
  • Conversion Tracking: Set up pixels and custom conversion events
  • Production-Ready: Built-in retry logic, rate limiting, and error handling

Installation

npm install
npm run build

Configuration

  1. Copy .env.example to .env:
cp .env.example .env
  1. Add your Meta access token:
META_ACCESS_TOKEN=your_token_here

Usage

With Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "meta-ads": {
      "command": "node",
      "args": ["/path/to/meta-ads-mcp-server/build/index.js"],
      "env": {
        "META_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

With MCP Inspector

npx @modelcontextprotocol/inspector build/index.js

Development

# Watch mode for development
npm run dev

# Build
npm run build

# Run tests
npm test

# Lint
npm run lint

Documentation

Requirements

  • Node.js >= 20.0.0
  • Meta developer account
  • Valid Meta access token with ads_management and ads_read permissions

License

MIT

Contributing

Contributions are welcome! Please see the for details.

Support

For issues and questions:

Resources