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

Example
You

What is in my Postcaly calendar this week, and when is the next free time for a LinkedIn post?

Your agent

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. 1

    Add the address

    Paste the Postcaly connector address into your assistant's connector or MCP settings (steps for each assistant are below).

  2. 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. 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.

Postcaly connector addresshttps://app.postcaly.com/mcp

Any 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

ToolWhat it doesPermissionChanges data
list_workspacesShows the one workspace this connection can useSee postsNo
get_workspaceWorkspace name, time zone, usual posting times and plan allowancesSee postsNo
list_usual_timesYour usual posting times and time zoneSee postsNo
get_plan_usageToday's posts used and left, and channels usedSee postsNo
list_channelsConnected channels and whether any needs reconnectingSee channelsNo
get_channel_optionsA channel's network choices and required answers, such as a YouTube titleSee channelsNo
list_postsPosts in a date range, drafts included if askedSee postsNo
get_postOne post with each channel's status, links and errorsSee postsNo
find_next_free_slotThe next usual posting time with room under your planSee postsNo
check_postChecks a post against each network's rules without saving itSee postsNo
list_mediaFiles in your media librarySee mediaNo
create_draftSaves a new draftSave draftsYes
schedule_postCreates and schedules a new postSchedule postsYes
schedule_draftSchedules an existing draftSchedule postsYes
update_postChanges a draft or scheduled post that has not gone outSave drafts or Schedule postsYes
move_postMoves a scheduled post to another day or timeSchedule postsYes
unschedule_postReturns a scheduled post to draftsSchedule postsYes
delete_postDeletes a draft or scheduled post. Never deletes a published postSave drafts or Schedule postsYes
publish_nowSends a draft or scheduled post to the networks nowPublish straight awayYes
upload_media_from_urlAdds a picture (up to 8 MB) or video (up to 50 MB) from a public https linkAdd mediaYes
describe_mediaSets a file's description (alt text)Add mediaYes

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.

Schedule your first post

14 days free on every plan, then from £15.99 a month. Cancel any time.

Start your free trial