TikTok Ads

v1.0.0Marketing & SEOstable

Enables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.

marketing-apimcp-server
Share:
32
Stars
0
Downloads
0
Weekly
0/5

What is TikTok Ads?

TikTok Ads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to manage tiktok advertising campaigns through the tiktok ads api. supports campaign creation, performance analytics, audience management, creative operations, and custom reporti...

Enables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.

This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables AI assistants to manage TikTok advertising campaigns

Use Cases

Create and manage TikTok advertising campaigns through natural language.
Analyze campaign performance and manage audiences via conversational interface.
Execute creative operations and custom reporting for TikTok ad strategies.
AdsMCP

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx tiktok-ads-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use TikTok Ads

The TikTok Ads MCP Server connects AI assistants to the TikTok Ads API, allowing campaign managers and marketers to create, monitor, and optimize advertising campaigns entirely through natural language conversations. It handles OAuth authentication, campaign management, ad group retrieval, and performance analytics with built-in rate-limit handling (1000 requests/hour). Teams managing multi-network advertising can also access this server's cross-platform integrations with Google Ads and Meta.

Prerequisites

  • Python 3.8+ with pip or uv installed
  • A registered TikTok Ads developer app with an App ID and App Secret (from ads.tiktok.com/marketing_api)
  • An active TikTok Ads advertiser account
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Clone the TikTok Ads MCP server repository and navigate into the project directory.

git clone https://github.com/AdsMCP/tiktok-ads-mcp-server.git
cd tiktok-ads-mcp-server
2

Install dependencies

Install Python dependencies using uv (preferred) or pip with a virtual environment.

# Using uv (preferred)
uv sync

# Or using pip
python -m venv venv
source venv/bin/activate
pip install -e .
3

Obtain TikTok API credentials

Log in to the TikTok Ads Marketing API portal, create or select an app, and note your App ID and App Secret. These are the TIKTOK_APP_ID and TIKTOK_APP_SECRET values.

4

Configure Claude Desktop

Add the server to your Claude Desktop configuration with your TikTok credentials as environment variables.

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "python",
      "args": ["-m", "adsmcp"],
      "env": {
        "TIKTOK_APP_ID": "your-app-id",
        "TIKTOK_APP_SECRET": "your-app-secret"
      }
    }
  }
}
5

Authenticate via OAuth

On first use, ask your AI assistant to initiate the OAuth login flow. Complete the TikTok authorization in the browser window that opens, then confirm the authorization code back to the assistant.

TikTok Ads Examples

Client configuration

Claude Desktop config for the TikTok Ads MCP server using Python module execution.

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "python",
      "args": ["-m", "adsmcp"],
      "env": {
        "TIKTOK_APP_ID": "your-tiktok-app-id",
        "TIKTOK_APP_SECRET": "your-tiktok-app-secret"
      }
    }
  }
}

Prompts to try

Natural language prompts you can use once the server is connected and authenticated.

- "List all active campaigns for advertiser ID 12345 and show me their current status."
- "Get the performance metrics for my top campaign over the last 7 days, broken down by ad group."
- "Switch to my other TikTok advertiser account and show me its campaigns."
- "What is my current authentication status for TikTok Ads?"

Troubleshooting TikTok Ads

OAuth login flow fails or browser window does not open

Ensure TIKTOK_APP_ID and TIKTOK_APP_SECRET are correct and that your app in the TikTok Ads portal has the Marketing API permission enabled. Check that your redirect URI matches what is configured in the portal.

Rate limit errors (HTTP 429) when fetching analytics

The API allows 1000 requests per hour with 10 concurrent requests. The server has built-in retry logic, but if you hit limits frequently, space out your analytics queries or request a rate limit increase from TikTok.

uv sync fails or dependencies are missing

Try the pip install path: create a virtual environment with 'python -m venv venv', activate it, then run 'pip install -e .' from the project root.

Frequently Asked Questions about TikTok Ads

What is TikTok Ads?

TikTok Ads is a Model Context Protocol (MCP) server that enables ai assistants to manage tiktok advertising campaigns through the tiktok ads api. supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install TikTok Ads?

Follow the installation instructions on the TikTok Ads GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with TikTok Ads?

TikTok Ads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is TikTok Ads free to use?

Yes, TikTok Ads is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Marketing & SEO MCP Servers

Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "tiktok-ads-mcp-server": { "command": "npx", "args": ["-y", "tiktok-ads-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use TikTok Ads?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides