SocialSchedule CLI — Schedule Social Posts from the Terminal

The SocialSchedule CLI is a headless social media scheduler for developers, DevOps, and AI agents. Authenticate, queue, and publish across platforms from your terminal—or pipe agent output straight into drafts.

Start free

Code samples

Samples stay in English — copy into your terminal, MCP client, or skill file.

Install

npm install -g @socialschedule/cli
# or
brew install socialschedule

socialschedule auth login
# stores a workspace-scoped token in your OS keychain

Schedule a post

socialschedule posts create \
  --platforms instagram,linkedin,x \
  --text "Ship notes for today's launch" \
  --media ./assets/launch.png \
  --at "2026-04-02T15:00:00Z"

Queue with optimal time

socialschedule queue add \
  --platform tiktok \
  --file ./caption.txt \
  --media ./clip.mp4 \
  --optimal-time

List calendar

socialschedule calendar list --from 2026-04-01 --to 2026-04-07

Agent pipe

echo "$AI_CAPTION" | socialschedule posts create \
  --platforms threads,bluesky \
  --stdin \
  --draft

MCP API Skills

Install and authenticate the SocialSchedule CLI

Install via npm or Homebrew, then authenticate with a workspace-scoped token. Store credentials in your OS keychain—not in shell history. For developers and AI agents, “Install and authenticate the SocialSchedule CLI” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Use separate tokens for CI versus local agent experiments. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Confirm workspace access before scripting launches. See the install commands in the samples below (English CLI syntax is intentional). When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Schedule a post from the command line (quickstart)

Create a post with platforms, text, media, and a timestamp in one command. Target Instagram, LinkedIn, X, and other connected accounts with platform flags. For developers and AI agents, “Schedule a post from the command line (quickstart)” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Prefer --draft in early agent loops until approvals are confident. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

List the calendar to verify the week looks right. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Conceptual CLI samples

Typical flow (illustrative): `npm i -g @socialschedule/cli` → `socialschedule auth login` → `socialschedule posts create --platforms instagram,linkedin --text "..." --at 2026-04-01T15:00:00Z --draft`. Prefer drafts until approvals are confident.

For agents: pipe generated captions via stdin, attach media paths for launch scripts, and fail closed when auth or upload errors. Store tokens in a keychain or CI secrets manager—never in shell history.

Use `socialschedule calendar list` and queue helpers to verify the week before a release announcement. Then confirm the same drafts in the web app.

Queues, calendars, and platform flags explained

The CLI mirrors the product model: calendars for dated plans, queues for optimal-time slots. Use optimal-time flags when you want analytics-informed windows. For developers and AI agents, “Queues, calendars, and platform flags explained” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Pass media files from disk for launch scripts. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Keep platform-specific captions when cross-posting. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Pipe AI agent output into scheduled posts

AI agents can generate captions and pipe them into SocialSchedule. Stdin-friendly commands make agent loops simple. For developers and AI agents, “Pipe AI agent output into scheduled posts” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Default to drafts + human approval for brand safety. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Pair with Skills for reusable calendar playbooks. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

CI-friendly publishing for product launch scripts

Product teams can schedule announcement posts from CI after a release tag. Use secrets managers for API tokens. For developers and AI agents, “CI-friendly publishing for product launch scripts” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Fail closed if media upload or auth fails. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Emit post IDs back into your release notes workflow. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

CLI vs API vs MCP: when to use which

CLI shines for scripts and terminals; API for product integrations; MCP for agent tool-calling. Use Skills when you want reusable playbooks on top of MCP/CLI. For developers and AI agents, “CLI vs API vs MCP: when to use which” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Many teams combine them: Skills plan, MCP drafts, CLI/API publishes. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Read sibling docs for architecture details. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Examples: Instagram, LinkedIn, and X one-liners

Common one-liners cover Instagram launches, LinkedIn thought leadership, and X threads/posts. Keep captions platform-native even when automating. For developers and AI agents, “Examples: Instagram, LinkedIn, and X one-liners” is not a buzzword section—it is an operating system: plan pillars, draft with AI, schedule into optimal windows, and measure outcomes that matter.

Verify connected accounts with a status command before big launches. SocialSchedule connects this workflow across Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, and Google Business Profile from one AI-native calendar and queue—not a bolted-on caption box on a 2012-style publisher. Keep platform-native formatting, approvals, and analytics in the same loop.

Browse the automation blog for governance patterns. Start free in the app, then authenticate the CLI with the same workspace. When you are ready, open https://app.socialschedule.ai/login to schedule live—or automate the same steps with CLI, MCP, API, and Skills while humans keep brand-voice guardrails.

Frequently asked questions

What is the SocialSchedule CLI?+

A command-line interface to authenticate, create, queue, and manage social posts in SocialSchedule—built for scripts and AI agents.

How do I install the SocialSchedule CLI?+

Install via npm (`@socialschedule/cli`) or Homebrew, then run `socialschedule auth login`.

Can AI agents schedule posts via CLI?+

Yes. Agents can call CLI commands or pipe generated captions into draft/schedule flows.

Which platforms can I target from the CLI?+

Any platform connected in your workspace, including Instagram, TikTok, LinkedIn, X, and others SocialSchedule supports.

How do I authenticate securely?+

Use workspace tokens stored in a keychain or CI secrets manager—never commit keys.

Can I schedule posts in a CI pipeline?+

Yes. CI-friendly commands support launch automation after builds or releases.

What’s the difference between CLI and API?+

CLI is optimized for terminals and scripts; the API is better for embedding scheduling into your own apps and backends.

Can I pass media files from the command line?+

Yes. Pass local media paths when creating posts.

Is the CLI included in all pricing plans?+

CLI access follows your workspace plan and permissions. Start free in the app, then enable developer access as needed.

Where can I find CLI command reference?+

Use `socialschedule --help` plus this docs page and related API/MCP docs for the full surface.

Authenticate the CLI and schedule your first post

Built for AI agents, launch scripts, and headless publishing.