Schedule social media posts with Cursor
Add Postozo to Cursor with a few lines of JSON. Then let Cursor's agent write launch posts from your code, docs and release notes, and schedule them.
How to connect Postozo to Cursor
You need a Postozo account with at least 1 connected channel. Cursor connects to Postozo's MCP server at https://app.postozo.com/mcp using an API key header.
- In Postozo, open Settings, Developers and copy your API key. It starts with
pz_live_. Treat it like a password. - Open
~/.cursor/mcp.jsonto use Postozo in every project, or.cursor/mcp.jsonin a project to use it there only. Create the file if it does not exist. - Add Postozo:
{
"mcpServers": {
"postozo": {
"url": "https://app.postozo.com/mcp",
"headers": { "Authorization": "Bearer ${env:POSTOZO_API_KEY}" }
}
}
}- Set the environment variable
POSTOZO_API_KEYto your key, or paste the key in place of${env:POSTOZO_API_KEY}if the file is not shared. - Save the file, reload Cursor, and ask the agent: "List my Postozo channels".
Cursor also supports OAuth for remote servers. We document the API key header because it is the method Cursor's docs show for headers and it needs no browser step.
Check it works
Ask the Cursor agent: "List my Postozo channels."
What Cursor can do with Postozo
Postozo gives Cursor 20 tools. A normal flow is: list your channels, read the rules of each network, check the post, find a free slot, then schedule it once you say yes.
| Tool | What it does | Changes data |
|---|---|---|
list_channels | List the connected social channels (accounts, pages) with their id, network, name and status. Call this first to get channel ids. | No |
list_networks | List every network this server supports and whether it can be connected. Useful to explain what is possible. | No |
list_customers | List customers. A customer groups channels (agencies use 1 per client). | No |
get_channel_rules | Get the posting rules for 1 channel: max length, media needs, whether comments are supported, and the settings schema (some settings are required, for example a title on YouTube or a board on Pinterest). Read before scheduling to that channel. | No |
find_free_slot | Find the next free posting time for these channels, using each channel's preferred posting times. | No |
check_post | Check a post against every channel's rules without saving it. Returns a list of problems (empty means it is fine). | No |
schedule_post | Create or edit a post for 1 or more channels. Supports drafts, scheduling, posting now, client review, threads with delays, per-channel text, network settings, tags and repeats. Returns the post id, its status and a preview link. | Yes |
list_posts | List posts on the calendar between 2 dates (default: last 7 days to next 30 days). | No |
get_post | Get 1 post with its text per channel, state per channel (queued, published, error...), links to the live posts, errors with a fix, comments and history. | No |
change_post_date | Move a post to a new date and time. | Yes |
retry_post | Retry the channels of a post that failed or could not be confirmed. Only use after the user confirms the post is not already live. | Yes |
delete_post | Delete a post from the calendar. Posts already live on a network stay live there. | Yes |
upload_media_from_url | Import an image or video from a public URL into the media library. Returns a media id to use in schedule_post. | Yes |
list_media | List files in the media library. | No |
list_tags | List tags used to label posts. | No |
get_analytics | Get account statistics for 1 channel from its network (7, 30 or 90 days). Some networks do not share statistics. | No |
get_post_analytics | Get statistics for 1 published post on 1 channel. Use the per-channel post id from get_post (channels[].root.id). | No |
get_workspace_stats | Counts from this workspace: posts by state, published posts per channel, and short link clicks. | No |
run_channel_tool | Run a network helper for 1 channel, for example list Pinterest boards, Reddit flairs or YouTube playlists, to fill a setting. get_channel_rules lists the tools for each channel. | No |
generate_image | Create an image with AI from a description and save it to the media library. Uses 1 image credit. Returns a media id. Only when AI images are turned on for your workspace. | Yes |
The server also offers 2 ready prompts: plan_week (plan 5 posts for the next 7 days about a topic) and repurpose (turn a link or text into 1 post per channel).
Example prompts
- "Read the README and write an X thread that explains what this project does. Check it with check_post, then save it as a draft."
- "Turn the last 5 commits into a short changelog post for LinkedIn and Discord."
- "Schedule the launch post for Tuesday 9:00 in my timezone on every channel."
- "Show me the Instagram rules, then write a caption for docs/hero.png."
- "What did we post last week, and which posts failed?"
- "Draft a Google Business Profile update about the new feature with a Learn more button to our docs."
Safety and control
- 14 of the 20 tools only read. The 6 that change data (schedule_post, change_post_date, retry_post, delete_post, upload_media_from_url and generate_image) are marked as write tools, so Cursor can ask you before it runs them.
- The server tells the AI to confirm the text, channels and time with you before it schedules or publishes.
- Ask for drafts ("save as drafts") or for client review ("send for approval") when you want a human to check first.
- A post is never sent twice. If Postozo cannot confirm a post went live, it marks it "could not confirm" instead of retrying on its own.
- Remove access any time in Postozo under Settings, Approved Apps, or by creating a new API key.
Sources
Questions
Can Cursor schedule posts with Postozo?
Yes. After you add Postozo's MCP server, Cursor can list your channels, check each network's rules, find free times and create drafts, scheduled posts or posts for client approval.
Should I commit .cursor/mcp.json?
Only with the key in an environment variable, never with the key itself.
Can Cursor post without asking?
The server asks the AI to confirm text, channels and time first. Ask for drafts if you want to review in Postozo.
Does it work with Cursor's background agents?
Cursor's docs describe MCP servers for its agent. We have not tested every Cursor mode, so start with the editor agent.
Does it cost extra?
No. The API and MCP server are included in every Postozo plan. Cursor has its own plans and limits.
Post to each network from Cursor
Cursor for Facebook
posts on your Facebook Pages
Cursor for Instagram
Instagram posts, carousels, Reels and Stories
Cursor for LinkedIn
LinkedIn profile and Company Page posts
Cursor for X
posts and threads on X
Cursor for TikTok
TikTok videos and photo posts
Cursor for Google Business Profile
Google Business Profile updates, offers and events
Connect Cursor to Postozo
Start a 7-day free trial, connect your channels, then add the server.
Create your free account