Home / Claude Code / X (Twitter)
Claude Code + X (Twitter) Skill

Claude Code + X (Twitter) Post Tweets & Media with AI

Use the Upload-Post skill to post tweets, photo tweets, and video tweets to X (Twitter) directly from Claude Code. Automatically thread long text, post single long-form tweets, and manage your X presence from the terminal.

Get Started Free View Docs

Install in Seconds

Works with Claude Code, Cursor, Windsurf, and any AI coding agent that supports skills.

Terminal
$ npx skills add Upload-Post/upload-post-skill

What You Can Post to X (Twitter)

Videos
Photos
Text

Features for X (Twitter)

Everything you need to publish and automate X (Twitter) content from your terminal.

Text Posts & Tweets

Publish text tweets to X directly from Claude Code. Compose tweets up to 280 characters, or use long text mode to bypass the character limit with auto-threading or single long-form posts.

Photo Tweets

Attach up to 4 images to a single tweet. Supports JPEG, PNG, GIF, and WebP formats. Upload-Post handles media upload, processing, and attachment to your tweet automatically.

Video Tweets

Post videos to X with captions. Supports MP4 format up to 512 MB and 140 seconds. Upload-Post manages the chunked upload process and waits for X's async video processing to complete.

Auto-Threading for Long Text

When your text exceeds 280 characters, Upload-Post automatically splits it into a numbered thread. Each tweet is broken at natural sentence boundaries to maintain readability across the thread.

Long Text as Single Post

Set x_long_text_as_post to true to publish text beyond 280 characters as a single long-form post instead of a thread. Ideal for announcements, articles, and detailed updates on X Premium accounts.

Analytics & Tracking

Monitor impressions, retweets, likes, and replies for every tweet published through Upload-Post. Track engagement trends across your X content from the Upload-Post dashboard.

How It Works

1

Install the Skill

Run the install command in your terminal. The skill is added to Claude Code instantly.

2

Connect X (Twitter)

Link your X (Twitter) account on the Upload-Post dashboard and create a profile with your API key.

3

Publish from Claude Code

Tell your AI agent to post content to X (Twitter). It handles formatting, uploading, and publishing automatically.

Start Posting to X (Twitter) from Claude Code

Join thousands of developers automating their social media workflow with AI. Free plan available.

Create Free Account View on GitHub

Prefer another integration path? Explore the X (Twitter) Upload API or the X (Twitter) MCP server.

Also Works With

One skill, 12 platforms. The same install command covers your entire social media stack.

TikTok Instagram YouTube LinkedIn Facebook X Threads Pinterest Reddit Bluesky Discord Telegram

Frequently Asked Questions

How does auto-threading work for long tweets on X?
When your caption exceeds 280 characters, Upload-Post automatically splits the text into multiple tweets and publishes them as a thread. The text is broken at natural sentence boundaries so each tweet reads well on its own. Each tweet in the thread is posted as a reply to the previous one, creating a clean numbered thread on your profile.
What is the x_long_text_as_post parameter?
Setting x_long_text_as_post to true tells Upload-Post to publish your caption as a single long-form post on X instead of splitting it into a thread. This uses X's native long-form post feature, which is available to X Premium subscribers. It is ideal for detailed announcements, blog-style content, or any text you want to keep in a single tweet rather than a thread.
What are the media limits for posting to X (Twitter)?
X supports up to 4 images per tweet (JPEG, PNG, GIF, or WebP, max 5 MB each) or 1 video per tweet (MP4, max 512 MB, up to 140 seconds). You cannot mix images and videos in the same tweet. Upload-Post validates these limits before sending to the X API and returns a clear error if your media exceeds them.
Can I schedule tweets for later from Claude Code?
Yes. Include the schedule_date parameter with an ISO 8601 timestamp (e.g., 2026-04-10T09:00:00Z) to schedule your tweet for a specific time. The post will be published to X at the specified time. Scheduling is available on Upload-Post paid plans starting at $12/month.
Can I post to X (Twitter) and other platforms at the same time?
Yes. Pass multiple platform names in the platform[] array — for example, platform[]=x and platform[]=linkedin — and Upload-Post will publish the same content to all specified platforms in a single API call. Each platform receives content formatted to its own requirements, so your tweet and LinkedIn post are both optimized automatically.