Schedulala for Claude Code
One command. Then just ask.
One claude mcp add and Claude Code schedules to 12 platforms, puts the link in the first comment, and reads the analytics back — from the same terminal you already work in. Not an MCP person? The CLI does all of it in plain Bash.
Read https://schedulala.com/SKILL.md and follow it to set up Schedulala.- 12 platforms
- One claude mcp add
- CLI in any Bash call
- First comments via API
- MIT skill
- $29/mo flat
01 / INSTALL
Two minutes, either path.
Everything below is copy-paste real — the same commands the hosted skill at schedulala.com/SKILL.md walks an agent through. Keys come from your dashboard; an sk_test_ key dry-runs the whole loop without publishing anything.
The one-liner (skill install)
Read https://schedulala.com/SKILL.md and follow it to set up Schedulala.
Paste this to Claude Code. It reads the hosted skill and installs itself.
MCP (stdio)
claude mcp add --transport stdio --env SCHEDULALA_API_KEY=sk_live_... schedulala -- npx -y @schedulala/mcp-server
The server reads SCHEDULALA_API_KEY from env only — never a config file.
Or the plugin skill
/plugin marketplace add schedulala/schedulala-agent
The full skill with references and worked examples. Outside Claude Code: npx skills add schedulala/schedulala-agent.
02 / THE FLOW
Key, connect, ask.
- 01
Get a key
Mint an API key in the Schedulala dashboard (Developer view), or let Claude Code run schedulala init with your email — it prints a code you approve in the browser. sk_test_ keys dry-run everything without publishing.
- 02
Add the server
One claude mcp add line with your key in the --env flag. Or install the plugin skill from the marketplace — it teaches the full workflow and works with MCP or the plain CLI.
One-linerRead https://schedulala.com/SKILL.md and follow it to set up Schedulala. - 03
Ask for the week
Schedule the week across your accounts, put each link in the first comment, and read back yesterday's numbers. Everything lands on the Schedulala calendar where you can edit or cancel before send time.
Works on every Schedulala plan — API, CLI, skill, and MCP are all included.
03 / POSTING
One prompt. A week on the calendar.
Describe the week you want and your agent writes each caption, adapts it per platform, and schedules the whole run - single posts, carousels, threads on X, Threads, Bluesky and Mastodon, or 25 posts in one bulk call.
Every platform's rules are validated before anything is created, and everything lands on the Schedulala calendar where you can edit, move, or cancel it before send time. No scheduling flag means draft - nothing publishes by surprise.
Bulk, threads, queues, drafts - the whole posting surface, from a conversation.
04 / THE FIRST-COMMENT FIELD
The link goes in the first comment. Automatically.
Anyone monetizing Facebook or LinkedIn traffic knows the play: keep the link out of the caption, drop it as the first comment seconds after the post goes live. Doing that by hand for every post is exactly the kind of work an agent should own — so it's one field on the API.
Pass firstComment on any post and Schedulala delivers it about 15 seconds after publishing — on 8 platforms through the same field, with per-comment targets on threads and per-platform delivery status (including the comment URL) reported back on the post. A failed comment never fails the post.
Eight platforms, one field. Not an Instagram-only bolt-on.
| Platform | First comment | Comment limit | Thread targets |
|---|---|---|---|
| 1,500 chars | |||
| no fixed limit | |||
| 1,000 bytes | |||
| YouTube | 10,000 chars | ||
| X / Twitter | 280 chars | ||
| Threads | 500 chars | ||
| Bluesky | 300 chars | ||
| Mastodon | instance-defined | ||
| TikTok | no comment API | ||
| no comment API | |||
| Telegram | no comment API | ||
| Google Business | no comment API |
Thread targets: on X, Threads, and Bluesky every post in a chain can carry its own comment ({target, text}). Full field reference: developers/docs/posts.
05 / ANALYTICS
Real numbers, not vibes.
Ask what worked last month and your agent pulls the actual reach, saves, engagement rate, and follower curve - per post, per account, or merged across everything you have connected.
Best posting times come from your own engagement history, not a blog post. YouTube videos come with transcripts and retention curves, which is how a Short becomes next week's posts.
The same agent that scheduled Tuesday can tell you how Monday did.
06 / ENGAGEMENT
Every comment triaged. Rude ones hidden.
Your agent reads the inbox across platforms, drafts replies in your voice, surfaces the ones that need you personally, and hides the ones you would rather nobody saw. Nothing is ever deleted.
Replies and hides are publishing actions, so the skill tells agents to confirm with you first - the inbox never runs away on its own.
Comments, replies, mentions, moderation - handled where the posts came from.
07 / LISTENING
It hears the conversation, too.
Keyword feeds watch public posts on Bluesky and Threads - your product, your niche, your competitors - and your agent can search them, read a thread's context, and reply from your account.
Up to 20 keywords per platform, managed from the same conversation. This is how an agent finds the customer complaining in public before you do.
Social listening wired into the same loop that posts and replies.
08 / EVERY TOOL, NAMED
Every tool, named.
This is the whole surface your agent gets: 31 tools plus 10 interactive panels. The 9 show_* widget tools and the attach_media drop zone render on claude.ai/ChatGPT only — everything else works in Claude Code, and media still has three widget-free paths (see the FAQ).
Publish and schedule
9Describe the week you want and it lands on your calendar, per platform, with a send time you can still change.
- create_post
- bulk_create_posts
- create_thread
- update_post
- cancel_post
- retry_post
- list_posts
- get_post
- validate_post
Analyze
5Ask what worked last month and get real numbers, not vibes, straight from the platform APIs.
- get_post_analytics
- get_follower_growth
- get_best_posting_times
- get_video_retention
- get_video_transcript
Engage
4Read the inbox, answer the good comments, hide the ugly ones. Nothing is ever deleted.
- list_comments
- list_mentions
- reply_to_comment
- hide_comment
Listen
4Search public posts by keyword on Bluesky and Threads, and keep a watch list Claude can read.
- search_feeds
- lookup_profile
- list_feed_keywords
- update_feed_keywords
Attach media
5Move your photos and video into a post. These tools carry files, they do not create them.
- upload_media
- list_media
- begin_generated_media_upload
- append_generated_media_chunk
- finish_generated_media_upload
Accounts and usage
4See which accounts are connected, connect a new one, and check where you are against your plan.
- list_accounts
- connect_account
- get_usage
- get_upgrade_link
Interactive widgets
10These do not answer in text. They render a real Schedulala panel inside the Claude conversation: your calendar, your inbox, an analytics chart, a post preview, or a drop zone for the file sitting on your desk.
- show_analytics
- show_calendar
- show_inbox
- show_post_preview
- show_comparison
- show_connections
- show_feeds
- show_leaderboard
- show_hello_widget
- attach_media
31 tools · 10 widgets · every one of them live today
09 / PROMPTS
Steal these prompts.
You do not have to learn tool names. Ask in plain English and your agent picks the tools — these are the asks worth keeping in a note.
The Monday batch
Read the drafts folder in this repo and schedule the best 5 as posts across bluesky, linkedin and mastodon this week — put each article link in the first comment, not the caption.
- create_post
- bulk_create_posts
The build-in-public thread
Turn today's changelog into a 3-post thread for X and Bluesky, and put the repo link in a first comment on the root post.
- create_thread
Did it land?
Check yesterday's posts — did every first comment get delivered? Give me the comment URLs.
- get_post
The dry run
Use my sk_test_ key and rehearse the whole week's schedule — I want to see exactly what would publish before anything real goes out.
- validate_post
- create_post
Best time, not guess time
When does my audience actually engage? Pull best posting times per account and move this week's schedule onto those slots.
- get_best_posting_times
- update_post
Photos and video come from you. Ask Claude to attach media and it opens an upload drop zone right in the conversation.
10 / CONTROL
Your agent, on a leash you hold.
Handing an agent your social accounts is a fair thing to be nervous about. Here is exactly what you keep control of, described the way it actually works.
01The key is the leash
Your agent authenticates with an API key you minted. Revoke it in the dashboard and every call stops immediately — scheduled posts and connected accounts are untouched.
- /dashboard?view=developer
02The calendar is the review step
Everything an agent schedules lands on your Schedulala calendar before it publishes. Edit it, move it, or cancel it — nothing is invisible.
- update_post
- cancel_post
03Dry-run keys exist
sk_test_ keys simulate the entire posting loop — post ids, per-platform results, first-comment delivery — without publishing a single thing or using quota.
- sk_test_
04The skill says confirm first
The hosted skill instructs agents to show you what will go out, where, and when before anything publishes. Credentials and payment only ever happen on schedulala.com, never in the chat.
- schedulala.com/SKILL.md
Claude drafts the words and picks the times. You supply the photos and video.
09 / PRICING
MCP costs nothing extra.
The connector is part of the product, not an add-on. Every plan includes it, tool calls are unlimited, and nothing here is metered per post or per token. You pay for how many accounts you manage.
Personal
$29/mo
10 social accounts
One creator, every platform.
- All 12 platforms
- Unlimited posts
- Analytics
- Comments and inbox
Unlimited tool calls
Team
$49/mo
25 social accounts
A brand with people in it.
- Everything in Personal
- Advanced analytics
- 3 team seats
- Priority support
Unlimited tool calls
Agency
$99/mo
100 social accounts
Many clients, one calendar.
- Everything in Team
- Unlimited team seats
- Unlimited workspaces
- Dedicated support
Unlimited tool calls
Seven days free, cancel any time before it ends. See the full pricing table.
10 / FAQ
The questions worth asking.
- Any of the three, and they mix well. claude mcp add gives Claude Code typed tools. The schedulala CLI works in any Bash call with zero tool-schema tokens — --json on every command and exit codes 0-7 an agent can branch on. The plugin skill is the workflow guide with worked examples, and it works with either. On claude.ai rather than the terminal, use the hosted connector instead: schedulala.com/integrations/claude.
- Three widget-free paths. upload_media takes any public URL. Images your agent generated go up in base64 chunks through the generated-media upload tools. And local files use attach_media's programmatic flow — it returns a presigned URL your agent PUTs the bytes to, documented in the skill's references/media.md. Full quality on every path.
- Where you put it, and nowhere else. claude mcp add stores it in that server entry's --env block; the CLI reads SCHEDULALA_API_KEY or the credentials schedulala init set up. The MCP server reads env only — it never opens the CLI's config file. Revoke the key in the dashboard and every call stops instantly.
- Yes. Mint an sk_test_ key: every create call is simulated end to end — you get a post id and per-platform sandbox results, nothing publishes, and no quota is used. Swap in the sk_live_ key when the flow looks right.
- Pass firstComment on any post and Schedulala comments on your own post about 15 seconds after it publishes — the standard way to keep links out of the caption. It works on 8 platforms through the same field, threads can target any entry on X, Threads and Bluesky, and the post response reports per-platform delivery with the comment URL.
- The skill, the CLI, and the MCP server are free and open (MIT). Publishing runs on a Schedulala plan from $29/mo flat — API and MCP access are included on every plan, no separate API pricing. A free key gets 2 connected accounts and 4 lifetime posts (no X posting) to try the loop.
Point your agent at one URL. Post everywhere.
The hosted skill installs, connects, and teaches the workflow. Your agent can put a week on your calendar tonight.
The one-linerRead https://schedulala.com/SKILL.md and follow it to set up Schedulala.