Connect your AI assistant
Connect your AI assistant
Postcaly has one connector address that ChatGPT, Claude, Cursor, Codex, Gemini CLI and other MCP clients can use. Add it, sign in to Postcaly, choose what the assistant may do, then ask for your posts in plain words.
Available now on every plan
Connects by MCP or skill and command-line tool
Use Postcaly today: 14 days free, then from £15.99 a month. Updated
What is in my Postcaly calendar this week, and when is the next free time for a LinkedIn post?
You have 4 posts scheduled, all on X and Threads. Your next free posting time is Wednesday 12:30. Shall I save a LinkedIn draft for then?
One address for every MCP client
Three steps, any assistant
The connector uses the Model Context Protocol (MCP), the open standard AI assistants use to reach other apps. You sign in with your Postcaly account; no API key is needed for assistants that support sign-in.
- 1
Add the address
Paste the Postcaly connector address into your assistant's connector or MCP settings (steps for each assistant are below).
- 2
Sign in and choose permissions
A Postcaly page opens. Pick one workspace and tick what the assistant may do. Publishing straight away is off unless you tick it.
- 3
Ask
Ask for what you need in plain words. Posts land in your Postcaly calendar as drafts or at the time you asked for.
https://app.postcaly.com/mcpAny Postcaly account with a confirmed email address can connect, on every plan.
Things you can ask your agent
Plain requests work. Your agent does the writing; Postcaly checks each network and keeps the schedule.
Look at my Postcaly calendar for next week and tell me which days have nothing booked.
Write three LinkedIn posts about our new opening hours and save them as drafts in Postcaly.
Add the picture at [paste a public https link] to my Postcaly library with a short description, then schedule a Bluesky post with it for Friday at 12:00.
Check this post against the X and Threads rules before saving it: ‘Our autumn menu starts Monday. Book a table at the link in our bio.’
Move my Thursday post to the next free posting time and tell me when it will go out.
Before you start
- A Postcaly account with at least one connected social channel. Every plan starts with 14 days free.
- A confirmed email address on your Postcaly account. Agent access is included on every plan.
- Membership of the workspace you connect. Creating an API key for the command-line tool needs the owner or admin role.
- An assistant that supports remote MCP connectors, such as Claude, ChatGPT with Developer mode, Claude Code, Codex, Cursor or Gemini CLI.
Steps for each assistant
Claude and Claude Cowork: open Settings, then Connectors, then Add custom connector. Paste the address, then sign in to Postcaly and choose Allow. Cowork uses the connectors on your Claude account.
ChatGPT: open Settings, then Apps and Connectors, switch on Developer mode, choose Create and paste the address. Sign in to Postcaly when ChatGPT asks.
Claude Code: run claude mcp add --transport http postcaly https://app.postcaly.com/mcp, or install the plugin with /plugin marketplace add postcaly/skills then /plugin install postcaly@postcaly. Sign in when asked.
Codex: run codex mcp add postcaly --url https://app.postcaly.com/mcp, then sign in when asked.
Gemini CLI: run gemini extensions install https://github.com/postcaly/skills.
Cursor: add {"mcpServers":{"postcaly":{"url":"https://app.postcaly.com/mcp"}}} to .cursor/mcp.json, or use the Add to Cursor link in github.com/postcaly/skills. Other MCP clients: add the address as an MCP server, then sign in when asked.
Agents that use skills (such as OpenClaw, NanoClaw or Paperclip): run npx skills add postcaly/skills. The skill is public at github.com/postcaly/skills.
Command line and scripts: create an API key in Postcaly under Settings, AI agents, then run npx -y github:postcaly/skills login and paste it. Then try npx -y github:postcaly/skills channels, or install it once with npm install -g github:postcaly/skills.
Permissions you can give
When you connect, Postcaly shows a sign-in page where you pick one workspace and tick permissions. The assistant gets only what you tick, and you can change it by disconnecting and connecting again.
- See posts (
posts:read): your workspace, posts, calendar, usual posting times and plan usage. - Save drafts (
posts:write): create and change drafts. Never schedules or publishes. - Schedule posts (
posts:schedule): schedule, move, change, return to drafts or delete posts that have not gone out. - Publish straight away (
posts:publish): send a post to the networks now. Off unless you tick it. - See media (
media:read): list your media library. - Add media (
media:write): bring in pictures and videos from a public link and write their descriptions. - See channels (
channels:read): your connected accounts and each network's options. Your social accounts' passwords and keys are never shared.
What it can do today
An assistant you connect can:
- See your channels, posts, usual posting times and plan usage
- Check a post against each network's rules before saving it
- Save drafts
- Schedule new posts or drafts for a time you give, or the next usual time
- Change, move, return to drafts or delete posts that have not gone out yet
- Add pictures (up to 8 MB) and videos (up to 50 MB) from a public https link, and write their descriptions
- Publish straight away, only if you ticked Publish straight away when you connected it
Coming next
More networks as each one opens, and listings in the official ChatGPT and Claude directories.
You stay in control
- You tick the permissions when you connect, for one workspace at a time.
- Publishing straight away is off unless you tick it. Without it, any time the assistant schedules must be at least 5 minutes ahead.
- Drafts only: switch it on in Settings, AI agents, and everything an assistant creates arrives as a draft for your team to check.
- Your plan limits and each network's rules always apply.
- Every post an agent makes is labelled with the agent's name in your calendar.
- Every action is listed under Activity in your workspace.
- Disconnect any time in Settings, AI agents. Access stops immediately.
- No passwords are shared. The assistant never receives your Postcaly password or your social accounts' passwords and keys. See the privacy policy.
Troubleshooting
- The Postcaly sign-in page says "Not found", or the assistant says agent access is not on for your account: confirm your email address first. In Postcaly, open Account to send a new confirmation link, then connect again. Accounts made with a phone number need an email address added and confirmed. If it still fails, write to info@postcaly.com.
- The sign-in page does not open or says it cannot connect: check the address is exactly
https://app.postcaly.com/mcp, remove the connector and add it again, and allow pop-ups for app.postcaly.com. - The assistant says it lacks permission: you did not tick that permission when you connected. Disconnect the assistant (in your assistant's settings or in Postcaly under Settings, AI agents), connect again and tick it.
- Scheduling or publishing is refused: the workspace has Drafts only switched on, or the post breaks a network rule or your plan limit. The assistant receives the reason in plain words; ask it to check the post first.
- A post shows as failed: open it in Postcaly to see each network's error, for example a channel that needs reconnecting.
- The assistant cannot see a channel: the channel is in a different workspace, or needs reconnecting in Postcaly under Channels.
- Still stuck? Email info@postcaly.com with the time and what you asked.
Data and privacy
- What Postcaly receives from the assistant is only what each request needs: post text, times, channel choices and media links you ask it to use. Postcaly does not read your chat history, memory or other files in your assistant.
- What the assistant receives is limited to the permissions you tick, in the one workspace you chose: for example post text, schedule times and channel names. Never passwords or social network keys.
- Storage: posts and media made by an assistant are stored like any other in your workspace, on our servers in Germany, and deleted with the workspace. Every action is recorded in your workspace's Activity list.
- Retention: when you disconnect an assistant its access ends at once; we keep the record of the connection for 12 months for security.
- No sharing or advertising: we do not sell this data or use it for advertising. Full details are in the privacy policy.
Support and security
Help with the connector: info@postcaly.com. To report a security issue, email the same address with "Security" in the subject.
Tool reference
| Tool | What it does | Permission | Changes data |
|---|---|---|---|
list_workspaces | Shows the one workspace this connection can use | See posts | No |
get_workspace | Workspace name, time zone, usual posting times and plan allowances | See posts | No |
list_usual_times | Your usual posting times and time zone | See posts | No |
get_plan_usage | Today's posts used and left, and channels used | See posts | No |
list_channels | Connected channels and whether any needs reconnecting | See channels | No |
get_channel_options | A channel's network choices and required answers, such as a YouTube title | See channels | No |
list_posts | Posts in a date range, drafts included if asked | See posts | No |
get_post | One post with each channel's status, links and errors | See posts | No |
find_next_free_slot | The next usual posting time with room under your plan | See posts | No |
check_post | Checks a post against each network's rules without saving it | See posts | No |
list_media | Files in your media library | See media | No |
create_draft | Saves a new draft | Save drafts | Yes |
schedule_post | Creates and schedules a new post | Schedule posts | Yes |
schedule_draft | Schedules an existing draft | Schedule posts | Yes |
update_post | Changes a draft or scheduled post that has not gone out | Save drafts or Schedule posts | Yes |
move_post | Moves a scheduled post to another day or time | Schedule posts | Yes |
unschedule_post | Returns a scheduled post to drafts | Schedule posts | Yes |
delete_post | Deletes a draft or scheduled post. Never deletes a published post | Save drafts or Schedule posts | Yes |
publish_now | Sends a draft or scheduled post to the networks now | Publish straight away | Yes |
upload_media_from_url | Adds a picture (up to 8 MB) or video (up to 50 MB) from a public https link | Add media | Yes |
describe_media | Sets a file's description (alt text) | Add media | Yes |
21 tools. Each one has a title and is marked read-only or as changing data, so your assistant can ask before it acts. Published posts and connected social accounts can only be changed by a person in Postcaly.
Questions
Is it available now?
Yes, on every Postcaly plan. Any account with a confirmed email address can connect it.
Which Postcaly plans can use it?
Every plan, including the 14-day free trial, for any account with a confirmed email address. Your plan's limits on posts and channels apply to the assistant the same as in Postcaly.
Do I need an API key?
Not for assistants that support sign-in, such as Claude, ChatGPT, Claude Code, Codex, Cursor and Gemini CLI: you sign in to Postcaly in your browser and approve the connection. The postcaly command-line tool uses an API key, which you create in Postcaly under Settings, AI agents.
Can the assistant post without asking me?
Only if you allow it. Publishing straight away is off unless you tick it when you connect. Without it, the assistant can save drafts or schedule posts at least 5 minutes ahead, and with Drafts only switched on everything arrives as a draft.
Which networks can it post to?
The networks your workspace has connected: today YouTube, X, LinkedIn profiles, Threads and Bluesky, with Facebook, Instagram, Google Business Profile, TikTok and Pinterest opening as each network approves Postcaly.
How do I disconnect it?
Open Settings, then AI agents, in Postcaly and disconnect it. It loses access immediately. You can also remove the connector in your assistant's own settings.
Does Postcaly see my conversations?
No. Postcaly only receives the requests the assistant sends to its tools, such as a post's text and time. It never reads your chat history, memory or files.
Related
Schedule your first post
14 days free on every plan, then from £15.99 a month. Cancel any time.
Start your free trial