doodle top mobile

Run Your Social Media from Cursor

Postiz plugs into Cursor, the AI code editor. Install it as a skill and Cursor's Agent can schedule, publish, and manage your posts across 30+ platforms — autonomously, from the integrated terminal, right alongside your code.

Please make sure there is always a human in the loop.

doodle left mobiledoodle right mobile

Install Postiz for Cursor

Two ways to connect — pick whichever you prefer. Both let Cursor's Agent post to your socials in seconds.

From the skills CLI

npx skills add gitroomhq/postiz-agent

Via the Postiz MCP server

https://api.postiz.com/mcp/YOUR_API_KEY

Then set your API key & go

# Set your API key (from Postiz settings)
export POSTIZ_API_KEY=your_api_key

# Cursor's Agent reads the bundled SKILL.md
# and discovers every Postiz command

# Now just ask Cursor's Agent to post for you

Built for Automation

🤖

AI Agent Ready

Every command outputs structured JSON. Designed for LLMs and automation pipelines to parse, plan, and execute social media workflows.

🌐

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms from a single skill.

🧵

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

📷

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

📅

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

⚙️

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

What is Cursor?

Cursor is the AI code editor used by millions of developers. Its Agent runs commands in the integrated terminal, edits your files, and takes real actions on your behalf — including managing your social media with Postiz.

💻

Editor Native

Talk to Cursor's Agent right inside your editor. No browser or extra app — open the Agent panel and manage your socials next to your code.

🧩

Skills & MCP

Cursor extends its abilities through Skills and the Model Context Protocol. Postiz works as a skill or as an MCP server — connect once and go.

Autonomous Agent

Cursor's Agent chains commands together — discovering integrations, uploading media, and scheduling posts across platforms without manual steps.

How Postiz Works with Cursor

When you install Postiz Agent in your project, Cursor's Agent automatically discovers it by reading the bundled SKILL.md file. This file tells Cursor what commands are available, what environment variables are needed, and how to compose posts with the right settings for each platform.

  • Install in one command: npx skills add gitroomhq/postiz-agent
  • Cursor's Agent reads the SKILL.md and learns all Postiz commands
  • Set POSTIZ_API_KEY and the skill is ready to use
  • Commands run in Cursor's integrated terminal
  • Works with any model: Claude, GPT, Gemini, and more

Install in Cursor

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Ask Cursor's Agent to verify it
"List my social media integrations"

# Cursor autonomously runs:
#   postiz integrations:list
# Output:
# - postiz: Social media automation
#   across 30+ platforms

Post From Your Editor

Tell Cursor's Agent what to post — it reads the Postiz skill, discovers your integrations, and handles the entire posting workflow autonomously in the integrated terminal.

From the Agent Panel

One prompt, full automation

Type a prompt in Cursor's Agent panel. It discovers your accounts via Postiz, uploads media, and schedules posts — all in the integrated terminal while you keep coding.

Cursor Agent

You: Post my blog article to Twitter,
  LinkedIn, and Reddit with the cover
  image, schedule for tomorrow at 9am

Cursor: Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:00 AM
  Post ID: abc-123

Parallel Tasks

Multiple agents, concurrent execution

Run multiple Agent tabs at once. Schedule a week of content in one while refactoring code in another — each task runs independently inside Cursor.

Multiple Agent Tabs

# Agent 1 — schedule content
> Schedule a week of daily posts
  to Twitter and LinkedIn, using the
  content from ~/content/drafts

# Agent 2 — check analytics
> Get my social media analytics
  for the last 30 days across all
  platforms and summarize the results

# Agent 3 — keep coding
> Refactor the auth module
  to use JWT tokens

Why AI Agents Love Postiz

  • Every command returns structured JSON for easy parsing
  • Built-in SKILL.md provides full command documentation
  • Discovery workflow lets agents explore available platforms
  • Platform-specific tools (flairs, playlists, boards) are dynamically queryable
  • No SDK needed — any agent that can run CLI commands works
  • Model-agnostic — works with Claude, GPT, Gemini, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  requirements:
    env:
      - POSTIZ_API_KEY
    binaries:
      - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Command Reference

CommandDescription
postiz integrations:listList all connected social media accounts
postiz integrations:settings <id>Get platform-specific settings schema
postiz integrations:trigger <id> <method>Trigger platform tools (flairs, playlists, etc.)
postiz posts:createCreate and schedule a new post
postiz posts:listList all scheduled and published posts
postiz posts:delete <id>Delete a scheduled post
postiz analytics:platform <id>Get analytics for an integration/channel
postiz analytics:post <id>Get analytics for a specific post
postiz upload <file>Upload media and get a reusable URL

Frequently Asked Questions

What is Cursor?

Cursor is the AI code editor. Its Agent mode runs commands in the integrated terminal, edits files, and completes multi-step tasks autonomously — including scheduling and publishing your social media through Postiz.

How do I install the Postiz skill in Cursor?

Run “npx skills add gitroomhq/postiz-agent” in your project, or connect the Postiz MCP server in Cursor settings. Then set your POSTIZ_API_KEY and Cursor's Agent discovers Postiz automatically by reading the SKILL.md file.

What can Cursor do with Postiz?

Cursor's Agent can draft, schedule, and publish posts, upload images and videos, create threads and comments, apply platform-specific settings, and pull analytics — across 30+ platforms, right from your editor.

Which social media platforms are supported?

30+ platforms, including X (Twitter), LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Threads, Bluesky, Mastodon, and more.

Does it work with other AI agents?

Yes. Postiz Agent is a CLI, so any agent that can run shell commands works — including Claude Code and ChatGPT. You can also connect through the Postiz MCP server.

Is it free to start?

Yes. You can create a Postiz account for free, connect your channels, and start posting with Cursor right away.

Start automating today

Install the Postiz skill and let Cursor handle social media posting across all your platforms from the editor.

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Grow your social media presence with Postiz.