X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate TikTok Ads MCP with Hermes

Connect Hermes to TikTok Ads MCP. List all active campaigns with spend, create campaign for new product launch, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
TikTok Ads logoTikTok Ads
Oauth2

TikTok Ads is TikTok's advertising platform for managing paid media and audiences. It helps advertisers reach engaged users with creative ad formats and performance insights.

131 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your TikTok Ads account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate TikTok Ads with

ChatGPT WorkClaude Cowork

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating TikTok Ads with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to TikTok Ads

Ask your agent to connect to TikTok Ads, or simply request any TikTok Ads-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new TikTok Ads connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to TikTok Ads or request any TikTok Ads-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the TikTok Ads MCP server, and what's possible with it?

The TikTok Ads MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your TikTok Ads account. It provides structured and secure access so your agent can perform TikTok Ads operations on your behalf.

Way Forward

With TikTok Ads connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every TikTok Ads action and event your agent gets out of the box.

Appeal Smart+ Ad

Submit an appeal for a Smart+ ad review decision.

Assign TikTok Account To Advertiser

Link a TikTok account to an ad account in the same Business Center.

Get Change Log Download Task Result

Read the status and change-log content returned for an advertiser's change-log task.

Check Advertiser Term Status

Check whether a TikTok advertiser has signed a specified agreement.

Check Change Log Download Task

Check whether an advertiser change-log download task is processing, successful, or failed.

Check File Names

Check whether one or more image or video file names are already used in an advertiser account.

Check GMV Max Occupied Custom Shop Ads

Check which Shopping Ads occupy one TikTok Shop identity or product asset.

Check TikTok Shop GMV Max Availability

Check a TikTok Shop's availability for Product GMV Max campaigns.

Check MMM Data Request

Check one MMM export job.

Check Smart+ Campaign Copy Task

Get the results of an asynchronous Upgraded Smart+ campaign copy task.

Check UnionPay Verification Requirement

Check whether a business license requires UnionPay verification before submitting advertiser verification details.

Create Business Center Asset Group

Create an Asset Group in a TikTok Business Center, add advertiser assets and members, and optionally assign each member an advertiser access role.

Create Business Center Organization Account

Create an Organization Account in an authorized Business Center.

Create Business Spark Ad

Create a campaign, ad group, and Spark Ad in one request.

Create Catalog Product Diagnostic Task

Create an asynchronous download task for catalog product diagnostic information.

Create Catalog Product Set by File

Create an E-commerce catalog product set from an uploaded CSV file.

Create Change Log Download Task

Create an asynchronous download task for an advertiser's change log.

Create Creative Welcome Message

Create a welcome message within a TikTok advertiser account.

Create Creative Pre-Review Task

Create a task to pre-review creative materials for one location.

Create GMV Max Campaign

Create a GMV Max campaign from TikTok's official campaign model.

Create GMV Max Session

Create a max delivery session for a product or a creative boost session for a video.

Create MMM Data Request

Create an irreversible Media Mix Modeling export job after explicit confirmation.

Create Smart+ Ad

Create a Smart+ ad disabled for review in an existing Smart+ ad group.

Create Smart+ Ad Group

Create a Smart+ ad group disabled for review in an existing Smart+ campaign.

Create Smart+ Campaign

Create a Smart+ campaign disabled for review.

Create Smart+ Campaign Copy Task

Create and start an asynchronous copy task for an Upgraded Smart+ campaign.

Create Video Fix Tasks

Create up to 10 Smart Fix tasks for advertiser-owned videos.

Delete Business Center Asset Group

Delete one Asset Group from a TikTok Business Center.

Delete Catalog Video

Permanently delete one uploaded video from an E-commerce catalog.

Delete Creative Assets

Delete video or image assets owned by a TikTok advertiser account.

Delete GMV Max Session

Permanently delete a GMV Max session from an advertiser account.

Delete Customized TikTok Posts

Permanently delete shop-level customized TikTok posts.

Delete Customized Identity

Permanently delete a customized user identity from an advertiser account.

Delete Search Ad Negative Keywords

Delete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account.

Delete Smart+ Resources

Permanently delete up to 20 Smart+ campaigns, ad groups, or ads.

Disable Business Center Advertiser

Irreversibly disable one ad account in a TikTok Business Center.

Get Ad Benchmarks

Get one page of ad benchmark dimensions and dynamic numeric metrics, scoped by exactly one ad_ids, adgroup_ids, or campaign_ids filter.

Get Advertiser Accounts

Return profile, status, timezone, currency, and other default details for specified authorized TikTok advertiser accounts.

Get Asset Binding Quota

Get advertiser binding quota usage for a TikTok identity asset.

Get Bid Protection Details

Get bid protection history for campaigns or ad groups over a date range.

Get Bid Protection Statuses

Get bid protection statuses for up to 200 campaigns or ad groups.

Get Business Center Advertiser Attributes

Get currencies and registration regions available when creating ad accounts in a Business Center.

Get Business Center Asset Group

Get the assets or members of an Asset Group in a Business Center.

Get Business Center Balance

Read the balance of a TikTok Business Center or Payment Portfolio.

Get Campaign Quota Information

Get SKAN Dedicated Campaign quota information by ad network.

Get Catalog Category Insights

Get up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.

Get Catalog Insight Filters

Get one page of provider-approved category, brand, or availability filter values for product insight endpoints.

Get Catalog Product Diagnostic Task

Get an asynchronous catalog product diagnostic task result.

Get Creative Assets

Return metadata for specified video or image assets in an authorized advertiser's Ads Asset Library.

Get Creative Pre-Review Task

Get the result of a creative pre-review task.

Get Custom Audience Details

Get current status and modification history for specified owned or shared custom audiences.

Get Custom Audience Sharing Log

Get the advertisers with which a specific TikTok custom audience has been shared, including each sharing status.

Get GMV Max Bid Recommendation

Get TikTok's recommended GMV Max bid for an eligible advertiser and shop.

Get GMV Max Campaign Info

Get information for one GMV Max campaign owned by an authorized advertiser.

Get GMV Max Sessions

Get max delivery or creative boost session details by 1 to 20 exact session IDs.

Get GMV Max Exclusive Authorization

Get an advertiser account's exclusive authorization status for a TikTok Shop.

Get GMV Max Report

Run one paginated Product or LIVE GMV Max campaign report.

Get MMM Download URL

Obtain a seven-day signed URL for a completed MMM compressed CSV.

Get MMM Request History

Retrieve MMM request metadata for a UTC+0 date interval.

Get Showcase Identity

Get the identity with Showcase permission under an ad account.

Get Smart+ Material Report

Get one page of Smart+ material overview or breakdown reporting.

Get Smart+ Review Info

Get review information for Smart+ ads or ad materials.

Get Video Fix Task

Get the results of a Smart Fix task.

Get In-Second Video Performance

Get one page of in-second AD or VIDEO performance.

List Ad Accounts Linked to TikTok Account

List one page of ad accounts linked to one TikTok account asset in a Business Center.

List Ad Groups

List regular or mixed-automation ad group inventory through TikTok's generic /adgroup/get/ endpoint.

List Ads

List regular or mixed-automation ad inventory through TikTok's generic /ad/get/ endpoint.

Get Advertiser Balance

Get one page of ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.

List Advertiser Budget Changes

Get one page of budget change audit records for an ad account.

List Advertiser Qualifications

List one page of reusable advertiser qualification records in a Business Center, optionally filtered by verification status.

List Advertiser Transactions

List one page of advertiser billing transactions accessible through a Business Center, with optional transaction type, fund type, account, and UTC date filters.

List Business Center Account Costs

Get one page of aggregate Business Center costs and itemized advertiser cost records.

List Business Center Account Transactions

Get one page of itemized billing transactions for a Business Center, its ad accounts, or a Payment Portfolio, including invoice, tax, billing-type, and account details.

Get Business Center Activity Log

Get one page of activity-log records for a Business Center.

List Business Center Advertisers

List one page of advertiser-account assets assigned to the authorized user in a specified TikTok Business Center.

List Business Center Asset Groups

Get one page of Asset Groups in a TikTok Business Center.

List Business Center Asset Partners

Get one page of Business Center partners associated with an asset.

List Business Center Billing Groups

Get one page of billing groups in a TikTok Business Center.

List Business Center Members

Get one page of members in a TikTok Business Center.

List Business Center Partners

Get one page of partners for a TikTok Business Center.

List Business Center Pixel Links

Get one page of ad accounts linked to a TikTok Business Center pixel.

List Business Centers

List one page of Business Centers accessible to the connected TikTok authorization, optionally restricted to one Business Center ID.

List Business Center Transactions

Get one page of Business Center-level cash or grant fund movements, with aggregate charged and paid amounts.

List Campaign Labels

List one page of campaign labels for an authorized advertiser.

List Campaigns

List regular or mixed-automation campaign inventory through TikTok's generic /campaign/get/ endpoint.

Get Catalog Diagnostics

Get one page of synchronous catalog product diagnostic information.

List Catalogs

List catalogs in a specified TikTok Business Center, optionally restricted to one catalog ID.

Get Catalog Videos

Get one page of uploaded videos from a catalog.

Get Creative Welcome Messages

Get one page of welcome messages within a TikTok advertiser account.

Get Creative Fatigue Results

Get one page of Creative Fatigue Detection results for an ad.

List Creative Portfolios

List one provider page of interactive creative portfolios for an advertiser.

List Custom Audiences

List one page of owned and shared custom audiences for an authorized advertiser, optionally restricted to specified audience IDs.

List GMV Max Campaign Sessions

List active max delivery or creative boost sessions for one Product GMV Max campaign ID.

List GMV Max Customized Posts

List one page of shop-level customized TikTok posts for GMV Max.

List GMV Max Identities

List identities available to an advertiser for GMV Max campaigns.

List TikTok Shops for GMV Max

List TikTok Shops available to an advertiser for GMV Max campaigns.

List GMV Max Videos

List one page of authorized or custom-post-eligible TikTok posts for a Product GMV Max campaign.

List Pangle Audience Packages

List the include and exclude audience packages available for an advertiser's Pangle targeting configuration.

Get Recommended Search Keywords

Get 20 TikTok search-keyword recommendations for a product, service, or brand query.

List Search Ad Negative Keywords

List one page of negative keywords for a campaign or ad group in an authorized advertiser account.

Get Showcase Products

Get one page of products available in a Showcase.

Get Showcase Regions

Get the regions targetable by a Showcase-bound identity.

Get Smart+ Ad Groups

List Smart+ ad group details through TikTok's dedicated /smart_plus/adgroup/get/ endpoint.

Get Smart+ Ads

List Smart+ ad details through TikTok's dedicated /smart_plus/ad/get/ endpoint.

Get Smart+ Campaigns

List Smart+ campaign details through TikTok's dedicated /smart_plus/campaign/get/ endpoint.

Get Trending Catalog Products

Get up to 50 trending products from an eligible E-commerce catalog.

List Trending Videos for Commercial Music

Retrieve the top trending TikTok videos that use a Commercial Music Library track in a selected region.

List Trending Commercial Music

Retrieve up to 100 popular, pre-cleared Commercial Music Library tracks for a TikTok Business Account, region, genre, and popularity window.

Get Trending Search Keywords

Get the top 20 TikTok search keywords, optionally personalized for a Business Account.

Set Search Ad Negative Keywords

Set negative keywords on Search Ads campaigns or ad groups.

Set Smart+ Delivery Status

Enable or disable up to 20 Smart+ campaigns, ad groups, or ads.

Share Creative Assets

Share controlled creative assets from one advertiser with specified target advertiser accounts.

Preview Smart+ Ad

Generate a preview link or iframe for a proposed or existing Upgraded Smart+ ad.

Submit UnionPay Verification

Submit identity and UnionPay account details to verify an eligible business license.

Unassign TikTok Account From Advertiser

Unlink a TikTok account from an ad account in the same Business Center.

Update Advertiser Account

Update one TikTok ad account's name, contact, company, license, certificate, promotion-link, address, or billing tax-number metadata.

Update Advertiser Budgets

Consequential financial action that updates, resets, increments, deducts, or sets minimum budgets for ad accounts in a Business Center.

Update Catalog

Update the name of a catalog owned by a TikTok Business Center.

Update Catalog Feed Schedule Status

Set one catalog feed schedule to ON or OFF.

Update GMV Max Campaign

Update supported fields on an existing GMV Max campaign; at least one field to update must be provided.

Update GMV Max Campaign Creatives

Remove creatives from a GMV Max campaign or add them back.

Update GMV Max Session

Update documented budget or schedule fields for a max delivery or creative boost session.

Update Pangle Block List

Update an advertiser's Pangle app block list by adding apps, removing apps, or clearing the existing list before adding replacements.

Update Search Ad Negative Keyword

Update the name or match type of one negative keyword attached to a Search Ads campaign or ad group.

Update Smart+ Ad

Update an existing Smart+ ad and its material configuration; at least one field to update must be provided.

Update Smart+ Ad Group

Update an existing Smart+ ad group's name, bid, budget, schedule, pacing, comment or sharing settings, and audience targeting.

Update Smart+ Ad Group Budgets

Update immediate total budgets or next-day scheduled daily budgets for Upgraded Smart+ ad groups.

Update Smart+ Ad Material Status

Enable or disable up to 20 materials belonging to a Smart+ ad.

Update Smart+ Campaign

Update an existing Smart+ campaign's supported fields; at least one field to update must be provided.

Upload Business Certificate Image

Upload a business certificate image for an ad account through a Business Center where the connected user is an administrator.

Upload Catalog Videos by File URL

Upload catalog videos from a file URL.

FRAMEWORKS

How to build TikTok Ads MCP Agent with another framework

ChatGPT Work logo

ChatGPT Work

Use TikTok Ads MCP with ChatGPT Work

Claude Cowork logo

Claude Cowork

Use TikTok Ads MCP with Claude Cowork

FAQ

Frequently asked questions

With a standalone TikTok Ads MCP server, the agents and LLMs can only access a fixed set of TikTok Ads tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from TikTok Ads and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right TikTok Ads tools.

Yes, absolutely. You can configure which TikTok Ads scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your TikTok Ads data and credentials are handled as safely as possible.

Start with TikTok Ads.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TikTok Ads tool your agent needs.Free to start.

Start building