Tiktok Ads MCP Server

A local Model Context Protocol (MCP) server for TikTok Ads API integration. It lets MCP clients such as Claude Desktop connect to TikTok Ads

Remote serverstreamable-httpPython

What is the Tiktok Ads MCP Server?

A local Model Context Protocol (MCP) server for TikTok Ads API integration. It lets MCP clients such as Claude Desktop connect to TikTok Ads, authenticate with a

Configuration and credentials

You need: - Python 3.10 or newer - uv for dependency management - A TikTok For Business account with Marketing API access - A TikTok developer app with an App ID and App Secret - An MCP client that supports local stdio servers, such as Claude Desktop

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
tiktok_ads_loginStart TikTok Ads OAuth authentication.
tiktok_ads_complete_authComplete OAuth using the authorization code.
tiktok_ads_auth_statusCheck current authentication status.
tiktok_ads_switch_ad_accountSwitch to a different advertiser account.
tiktok_ads_get_campaignsRetrieve campaigns for the advertiser account.
tiktok_ads_get_campaign_detailsGet details for a specific campaign.
tiktok_ads_get_adgroupsRetrieve ad groups for a campaign.
tiktok_ads_get_adgroup_detailsGet details for a specific ad group.
tiktok_ads_get_adsRetrieve ads by campaign, ad group, ad ID, or status.
tiktok_ads_get_ad_detailsGet details for a specific ad.
tiktok_ads_get_campaign_performanceGet campaign-level metrics.
tiktok_ads_get_adgroup_performanceGet ad group-level metrics.
tiktok_ads_get_ad_performanceGet ad-level metrics.
tiktok_ads_get_audience_breakdownBreak down campaign, ad group, or ad performance by audience dimension.
tiktok_ads_wasted_spend_auditRun a read-only audit for spend and clicks without conversion signal.
tiktok_ads_get_custom_audiencesList custom audiences.
tiktok_ads_get_advertiser_infoGet account-level advertiser details such as currency, timezone, status, industry, country, and creation time.
tiktok_ads_get_location_infoResolve TikTok targeting location IDs.
tiktok_ads_get_pixel_listList pixels attached to the advertiser account.
tiktok_ads_get_pixel_event_statsGet pixel event activity for a date range.

How to install the Tiktok Ads MCP Server

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/tiktok-ads-mcp-server",
        "run",
        "python",
        "run_server.py"
      ],
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "YOUR_TIKTOK_APP_SECRET"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

You need: - Python 3.10 or newer - uv for dependency management - A TikTok For Business account with Marketing API access - A TikTok developer app with an App ID and App Secret - An MCP client that supports local stdio servers, such as Claude Desktop

VariableDescriptionRequired
TIKTOK_APP_IDDeclared in the maintainer’s client configuration.Check documentation
TIKTOK_APP_SECRETDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Tiktok Ads to Authentication.”

Frequently asked questions

A local Model Context Protocol (MCP) server for TikTok Ads API integration. It lets MCP clients such as Claude Desktop connect to TikTok Ads, authenticate with a Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.