Meta Ads MCP Server — Claude Code MCP server: setup
This MCP server lets an AI agent manage Meta Ads campaigns, inspect performance, work with targeting, and upload media.
claude mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcpWhat Meta Ads MCP Server does
Meta Ads MCP Server connects an MCP client to Meta Marketing API v26.0. Its tools cover campaign creation and changes, insights, targeting discovery, delivery estimates, ad previews, bulk operations, and media uploads.
You can run it locally through @cesteral/meta-mcp with npx, or connect to a Streamable HTTP deployment at https://{host}/meta-mcp/mcp. The project describes this connector as self-hostable and lists 27 tools for the Meta Ads server.
A Meta Marketing API Bearer token is required. Without that credential, the server cannot access the advertising account, so authentication has to be ready before testing agent requests.
What it helps with
- create and update Meta Ads campaigns
- pull performance data through insights
- discover suitable ad targeting
- estimate campaign delivery
- upload media and inspect ad previews
Example prompts for the agent
- Pull Meta Ads insights for this campaign and explain the main changes.
- Draft a campaign with this targeting, then show the ad preview before applying it.
- Upload this media file and prepare a bulk update for the selected campaigns.
How to install Meta Ads MCP Server
1Platform CLI
claude mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcp2Platform CLI: remote server
claude mcp add --transport http meta-mcp https://{host}/meta-mcp/mcp1Platform CLI
codex mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcp2Platform CLI: remote server
codex mcp add meta-ads-mcp-server --url https://{host}/meta-mcp/mcp1Config file
{
"mcpServers": {
"meta-ads-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cesteral/meta-mcp"
]
}
}
}2Config file
{
"mcpServers": {
"meta-ads-mcp-server": {
"url": "https://{host}/meta-mcp/mcp"
}
}
}1Config file
{
"servers": {
"meta-ads-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cesteral/meta-mcp"
]
}
}
}2Config file
{
"servers": {
"meta-ads-mcp-server": {
"type": "http",
"url": "https://{host}/meta-mcp/mcp"
}
}
}1Platform CLI
gemini mcp add meta-ads-mcp-server npx -y @cesteral/meta-mcp2Platform CLI: remote server
gemini mcp add -t http meta-ads-mcp-server https://{host}/meta-mcp/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Meta Ads MCP Server
How do I install Meta Ads MCP Server in Claude Code?
Run claude mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcp.
What does Meta Ads MCP Server do?
It gives an AI agent tools for Meta Ads campaign changes, insights, targeting discovery, delivery estimates, previews, bulk actions, and media uploads.
What is required to connect it to Meta Ads?
The server uses a Bearer token with Meta Marketing API v26.0. The token allows access to the advertising account.
