How to post to TikTok from Claude Code

Set it up and post, step by step

Prompt to copy once TikTok is connected: Write a TikTok caption for ./clips/launch.mp4 from what is in CHANGELOG.md, show it to me, and schedule it public for Friday at 7pm my time.

1. Add PostWire to Claude Code

   In your terminal run claude mcp add --transport http postwire https://postwire.io/api/mcp (add --scope user to have it in every project), then type /mcp in Claude Code and pick postwire to sign in. The sign-in asks for your email and a 6-digit code, which also creates a free PostWire account if you have none: no password and no card.

2. Or install the TikTok skill instead

   npx skills add https://postwire.io --skill tiktok-upload adds the skill to Claude Code (and to the other agents on the machine). It uses your key from the environment: copy it in the dashboard under API & MCP and set POSTWIRE_API_KEY. The skill is a plain file you can read first: tiktok-upload/SKILL.md.

3. Connect your TikTok account

   Ask "connect my TikTok". Claude Code calls create_connect_link and prints a link; open it, sign in on TikTok's own page and allow PostWire to post. You do this once per account.

4. Give it the video, or photos

   Give Claude Code a public https link to an MP4 or MOV file. A file on your computer goes through an upload page: ask for one (create_upload_link), pick the file there, and Claude Code gets its link. One file can be up to 100 MB on the free plan and 1 GB on paid plans. Photos instead of a video make a TikTok photo post of up to 35 images (PNG is turned into JPEG for you). No video yet? make_video_from_text turns a few lines into an 8-12 second vertical MP4 (1080×1920) to show you before anything is posted.

5. Ask for the caption and pick who sees it

   "Write the caption." generate_posts returns a draft and publishes nothing: a hook-first line and a few specific hashtags, within TikTok's 2,200 characters. Then say who can see it: public, friends (mutual followers) or private. TikTok asks the account owner to choose this for every post; if nobody chooses, PostWire posts it private and says so in the result.

6. Publish now, or schedule it

   Say "post it" and Claude Code calls post_to_social. Say "schedule it for Friday at 7pm" and it calls schedule_post, up to 365 days ahead, or with run_at: "next_slot" for your next free posting hour. This is the call:

   {
     "name": "schedule_post",
     "arguments": {
       "platforms": ["tiktok"],
       "per_platform": { "tiktok": {
         "text": "We cut our build from 9 minutes to 2. Here is the one change. #devtools #ci #buildinpublic"
       } },
       "video_url": "https://example.com/clips/launch.mp4",
       "privacy": "public",
       "run_at": "2026-10-23T19:00:00-05:00"
     }
   }

7. Get the link

   TikTok processes the video after the call returns. Claude Code calls get_post_status with the returned id until it has the TikTok link, usually within a minute or two. If TikTok refuses the video, the result carries a code, what happened and the fix.

"What's scheduled on TikTok?" calls list_scheduled_posts and "cancel Friday's TikTok" calls cancel_scheduled_post; the same queue is on the dashboard's Queue page. Prefer to set it up by hand first? Open the dashboard, connect the account under Accounts and copy your key under API & MCP.