A TikTok MCP server for Claude, Codex and Cursor

The short answer

1. Create a free ReelGenie account.
2. Add https://reelgenie.app/api/mcp/agent to your agent and sign in. Codex uses a token instead.
3. Connect your TikTok account on ReelGenie’s Accounts page.
4. Your agent makes the slides, or you bring a finished video, and it saves the exact files for review.
5. Check the post, then approve the account and time.
6. When the result says “Draft ready”, open TikTok, add a sound and post.

What this TikTok MCP server does

An MCP server gives your agent tools it can call. This one lets Claude, Claude Code, Codex, Cursor or your own agent hand finished TikTok posts to ReelGenie, which keeps each one private until a person approves it and then sends it to the TikTok account you connected. You approve every post before it goes live.

• Hosted: nothing to install or run, and no TikTok developer app or API keys of your own.
• The same files: ReelGenie sends the files your agent uploaded, in order, not a copy made from a chat preview.
• A result per account: Scheduled, Draft ready, Published or Failed with TikTok’s reason.
• Also Instagram and YouTube: the same server posts there too, as the Instagram MCP server and YouTube MCP server pages explain. Those are the only three platforms.

It is listed in the official MCP Registry as app.reelgenie/reelgenie.

1. Add the server to your agent

Create a free ReelGenie account first. Then pick your agent. Signing in opens a ReelGenie page that lists what the agent can do, including publishing after your explicit approval. Before it approves anything, your agent asks you in the chat and repeats the account and time. You can also approve in ReelGenie. To keep approval in ReelGenie only, connect with a token from the Agents page that leaves out publishing.

Claude desktop or web

Open Settings → Connectors, choose Add custom connector and enter the server URL. To upload images or video made in the chat, also open Settings → Capabilities, turn on Create and edit files and Use the internet while making files, add reelgenie.app under Allowed websites, then start a new chat. The Claude setup page has every step.

https://reelgenie.app/api/mcp/agent

Claude Code

Install the ReelGenie plugin from the Claude setup page, or add the server directly, then choose reelgenie in /mcp to sign in.

claude mcp add --transport http reelgenie https://reelgenie.app/api/mcp/agent

Cursor, VS Code, Windsurf and other MCP clients

Any client that supports remote MCP servers with sign-in can use the same URL. In Cursor, add it to .cursor/mcp.json, then sign in when Cursor asks. The Cursor guide has every step. For GitHub Copilot in VS Code, the file is .mcp.json and the server needs "type": "http"; the VS Code guide shows it. In Windsurf, now called Devin Desktop, add it to ~/.config/devin/mcp_config.json or .devin/mcp_config.json and sign in; the Windsurf guide has the steps.

{ "mcpServers": { "reelgenie": { "url": "https://reelgenie.app/api/mcp/agent" } } }

For a script or an agent that can’t sign in, a team admin can create a revocable token on ReelGenie’s Agents page.

Codex

Codex connects with a token from the Agents page, read from an environment variable so it stays out of the chat. The Codex setup page has a prompt that walks through it.

codex mcp add reelgenie --url https://reelgenie.app/api/mcp --bearer-token-env-var REELGENIE_MCP_TOKEN

ChatGPT

The ReelGenie app for ChatGPT is in preview. See the plugin walkthrough for its current availability.

Then check the connection before making anything:

Check that the ReelGenie connection works and list my workspaces and connected social accounts.

2. Connect your TikTok account

Your agent can’t sign in to TikTok for you. Open ReelGenie’s Accounts page, choose TikTok and sign in there. The account card shows what ReelGenie can do with it: send drafts to your TikTok inbox, and Direct Post only where TikTok allows it.

3. Make the post

Agree on the idea first. Your agent reads the workspace’s brand brief before it suggests anything.

Suggest three TikTok photo carousel ideas for [topic] that fit my brand brief. Give the first slide’s opening line for each and recommend one.

• Text slides: your agent can lay out a hook, tips, a quote and a closing slide through ReelGenie’s slide tool, in your brand colours: 1080 × 1350 by default, or full-screen 1080 × 1920 if you ask for the story size. No image tool needed.
• Photos or images: JPEG or WebP, at most 1080 × 1920. PNG can’t go to TikTok, so ask for JPEGs.
• Video: a finished MP4 up to 500 MB, at 23 to 60 frames per second (30 is safe). ReelGenie doesn’t make video, and neither does the server; bring it from your editor or a video tool.

For a slideshow from start to finish, see the TikTok slideshow page.

4. Review and approve

Your agent uploads the files straight from your computer and saves the post as private. ReelGenie shows the slides in a phone frame, in order, with the full caption.

Save these slides with the caption as a private ReelGenie post and give me the review link. Don’t send anything yet.

Then tell your agent the TikTok account and the time. It repeats those details back before anything is approved. You can also approve in ReelGenie instead.

Send this to my TikTok account as a draft on Friday at 18:00 Sydney time. Confirm the details with me first.

Before approval, ReelGenie checks the delivery and warns you if the TikTok sign-in won’t last until the scheduled time, or if a TikTok daily limit is already used up that day.

Draft ready or Direct Post?

TikTok decides which of these an app may use for your account.

• Draft (most accounts today): the post goes to your TikTok inbox and the result reads Draft ready. That isn’t published yet. Open TikTok, add a sound if you like, and post. TikTok holds at most 5 waiting drafts per account.
• Direct Post: appears only when TikTok has enabled it for your account. You then choose who can view the post, and whether to allow comments, Duet and Stitch.

Sounds can’t be added through TikTok’s API, so a draft is also how you post with a trending sound.

5. Check whether it actually posted

Scheduled isn’t posted. Each account shows its own result:

• Scheduled: delivery is planned and nothing has been sent yet.
• Draft ready: the post is in your TikTok inbox and needs your final step.
• Published: TikTok reports the post as live.
• Failed: TikTok’s reason, in plain words, and what to do next.

What happened to my TikTok post? Tell me the result for each account and what I need to do next.

If a post you scheduled never showed up, the missed post checklist walks through it.

The TikTok tools your agent gets

These are some of the server’s tools that a TikTok post uses, by their real names:

• reelgenie_health and list_connected_accounts: check the connection and see which TikTok accounts are connected.
• create_slide_post: lay out text slides in your brand colours and save them for review.
• begin_finished_image_post and begin_finished_video_post: upload your own finished images or MP4 straight from disk.
• get_tiktok_posting_options: read the account’s current Direct Post choices, where TikTok allows Direct Post.
• check_post_delivery: run the checks before approval.
• approve_post: approve the exact account, delivery and time, only after you say yes.
• get_finished_post and diagnose_publish_failure: read each account’s result and, if it failed, why.

Hosted server or your own TikTok app?

Open-source TikTok MCP servers run on your computer and post with your own TikTok developer app. That means registering the app with TikTok, asking for access to its Content Posting API, and keeping the keys safe. It suits you if you want everything on your own machine.

A hosted server like ReelGenie skips that: you sign in to TikTok on ReelGenie’s Accounts page, and ReelGenie keeps the TikTok sign-in, holds each post for approval and records what TikTok answered. The trade-off is that it can’t be self-hosted. Compare ReelGenie with Blotato, Postiz and others.

What it can’t do

• It can’t sign in to TikTok or finish a draft inside the TikTok app. Those steps are yours.
• It doesn’t make photos or video. Use the slide tool, your own media, or a tool that makes them.
• It won’t send anything you haven’t approved: the post, the account, the delivery and the time.
• It can’t turn on Direct Post. TikTok decides that for each account.
• It posts only to TikTok, Instagram and YouTube.

Questions about the TikTok MCP server

Can Claude post to TikTok by itself?

No. Claude has no TikTok login, and TikTok only lets approved apps post. With ReelGenie’s MCP server added, Claude hands over the finished post, you approve it, and ReelGenie sends it to the TikTok account you connected.

Is the TikTok MCP server free?

Yes, on ReelGenie’s forever-free plan: 30 posts a month, 1 brand and 3 connected accounts, with no card. Solo is US$19/month for unlimited posts. Your agent’s own plan is separate.

Why does my post say Draft ready instead of Published?

For most accounts today TikTok receives posts from apps as drafts in your TikTok inbox. Draft ready means it isn’t published yet: open TikTok, add a sound if you like, and post. Direct Post appears only when TikTok has enabled it for your account.

Does it post without my OK?

No. Saving a post keeps it private for review. Nothing is sent until the exact post, account and time are approved, by you in ReelGenie or by your agent after you say yes in the chat.

Does it work with Cursor or my own agent?

Yes. Any MCP client that supports remote servers with sign-in can use https://reelgenie.app/api/mcp/agent. A script that can’t sign in can use a revocable token from the Agents page.

Can I add a trending sound?

Not through the server. TikTok’s API can’t add sounds, so send the post as a draft and add the sound in TikTok before you post.