PostOnce home
tiktok logo

TikTok + PostOnce

TikTok MCP Server

TikTok MCP server for Claude, ChatGPT, Cursor and Codex. Your AI agent can write, publish and schedule TikTok videos and photo slideshows through TikTok's official API, with no scraping, no browser automation and no TikTok developer app.

Connect your agent

Requires a PostOnce account, API access, and your own API key.

MCP server URL
https://postonce.to/mcp
View tiktok-mcp on GitHub

What your agent can do on TikTok

Post a video now (up to 10 minutes, 4 GB)

create_upload_url, upload, then create_post with media

Post a photo slideshow (1 to 35 images, JPEG or WEBP)

Upload each image, then create_post with the images in order

Schedule a post for later

create_post with publish_at

Send it to your TikTok inbox as a draft to finish in the app

platform_options: { "publish_mode": "draft" }

Set who can see it, or turn off comments, duets or stitches

platform_options: privacy (public, friends, followers, private), comments, duet, stitch set to false

Pick the video cover

video_cover_timestamp_ms in platform_options, or a thumbnail_url on the video

Label a video as AI-generated

platform_options: { "ai_generated": true } (direct video posts)

Save a draft in PostOnce to finish later

create_draft

Check whether a post went out, and get its URL

get_post

Change or cancel a scheduled post

update_post, cancel_post

Post the same video to TikTok and other platforms

Add more targets to create_post (Instagram, YouTube, LinkedIn, X, Threads, Facebook, Pinterest, Bluesky)

Not supported: text-only posts, GIFs, mixing photos and video in one post, choosing the music on a slideshow (TikTok adds music to photo posts automatically), TikTok Stories and LIVE, analytics, reading or replying to comments, DMs, and editing or deleting posts after they're published. Captions over 2,200 characters are cut off, and hashtags beyond 5 are removed.

Connect TikTok to your agent

You need a PostOnce account with your TikTok account connected. Try it free for 7 days without entering a card.

Claude and ChatGPT

Add a custom connector with this URL and sign in with PostOnce. No API key.

Connector URL
https://postonce.to/mcp

Claude setup · ChatGPT setup

Claude Code

Install the plugin for the connection and the TikTok skills, then set POSTONCE_API_KEY.

Terminal
claude plugin marketplace add postoncehq/plugins
claude plugin install tiktok-mcp@postoncehq

Claude Code setup

Cursor, Codex and other clients

Point any MCP client at the URL above over Streamable HTTP with the header Authorization: Bearer and your PostOnce API key. Never paste the key into chat.

Cursor setup · Codex setup · Any MCP client

TikTok skills included

The plugin ships these Agent Skills so your agent knows what works on TikTok before it posts. They work in Claude Code, Codex, Cursor and any client that reads Agent Skills.

  • tiktok-script-generator

    Writes short-form video scripts: the hook, the beats, on-screen text, B-roll and the ending.

  • tiktok-hook-generator

    Gives 10 first-3-second hooks for a topic, each with the spoken line, the on-screen text and the opening shot.

  • tiktok-caption-generator

    Writes captions built for TikTok search: the keyword up front, a clear line of context, and up to 5 hashtags.

  • tiktok-slideshow-maker

    Plans and builds a photo-mode slideshow (up to 35 images at 1080×1920 or 1080×1440), with the caption.

  • tiktok-hashtag-generator

    Picks 3 to 5 hashtags that describe the video, mixing topic and niche tags.

  • tiktok-bio-generator

    Writes TikTok bio options that fit in 80 characters, for you to paste into your profile.

  • tiktok-content-calendar

    Plans 1 to 4 weeks of TikToks from your goals or a source you already have, then schedules them.

  • postonce

    Publishing workflow: pick the right account, upload media, schedule, and confirm the post actually went live.

Try these prompts

Try this prompt

Turn these 8 tips into a TikTok slideshow with a caption and post it Saturday at 11am.

Try this prompt

Write a search-friendly caption for this video and schedule it on TikTok for 7pm.

Try this prompt

Write three hooks for this video idea, then schedule the video for tomorrow at 6pm.

TikTok MCP questions

Is there an official TikTok MCP server?

This server uses TikTok's official API through PostOnce. Your agent talks to PostOnce over MCP, and PostOnce publishes through TikTok's official posting API with the permissions you grant when you connect.

Can Claude post to TikTok?

Yes, once it's connected to an MCP server that can publish, like this one. Claude writes the caption, uploads your video or images, then calls create_post.

Is it safe for my TikTok account?

Yes. Posts go through TikTok's official API. Many TikTok MCP servers on GitHub drive a logged-in browser session or an unofficial, scraped API instead, which TikTok's terms don't allow and which can get accounts restricted.

Do I need a TikTok developer app or API approval?

No. PostOnce holds the TikTok API access; you just connect your account.

Can it post TikTok slideshows (photo mode)?

Yes. Send 1 to 35 JPEG or WEBP images in order and they post as a photo post. TikTok adds music to photo posts automatically; you can't pick the sound through the API.

Can it save a post as a draft in TikTok?

Yes. Set publish_mode to draft and the post lands in your TikTok inbox, where you finish it (add a sound, edit, post) in the app. A video draft arrives without its caption, so paste the caption in TikTok before posting.

Is it free?

The skills are free and MIT-licensed on GitHub. Publishing runs through a PostOnce account, which you can try free for 7 days without entering a card. After that, see pricing.

MCP servers for other platforms

The same connection publishes everywhere PostOnce supports. Each platform has its own skills: LinkedIn MCP, Instagram MCP, YouTube MCP, Facebook MCP, X (Twitter) MCP, Threads MCP, Bluesky MCP, Pinterest MCP.

Let your agent post to TikTok

Connect your agent

Requires a PostOnce account, API access, and your own API key.