Planoly MCP

Generating content is the easy part. Publishing to your socials is the manual part. Now there is an MCP which acts as the publishing layer directly to socials. No more manual exporting of files. No more pain.

Documentation

Planoly MCP Server

MCP License: MIT Docs

Connect AI assistants to Planoly — plan, create, schedule, and analyze social media content across Instagram, TikTok, YouTube, Pinterest, Facebook, LinkedIn, Threads, and X, straight from Claude, Cursor, or any MCP client.

This is a remote MCP server, hosted by Planoly:

https://mcp.planoly.com/mcp

There is nothing to install or run — you connect your MCP client to the URL above and sign in with your Planoly account via OAuth. This repository hosts the public documentation and registry metadata for the server.

What you can do

  • Create and schedule posts across all your connected channels in one call — Instagram, TikTok, YouTube, Pinterest, Facebook, LinkedIn, Threads, and X — with shared caption/media and per-platform overrides: Instagram tags, collaborators and reel audio, TikTok sounds and privacy, YouTube visibility, Pinterest boards, and more.
  • Manage your content calendar — list drafts and scheduled posts, see why a post failed, edit captions and settings, reschedule (including Instagram Best Time slots), or delete.
  • Work with your media library — browse, search, organize and move between folders, preview media, import from URLs, or upload new assets.
  • Analyze performance — Instagram, TikTok, LinkedIn, and Pinterest analytics, per-post Instagram performance, public account research, and shareable report links.
  • Write in your brand voice — have Planoly learn how you write from your own posts, then read it back before writing captions.
  • Handle your inbox — read and search Instagram DMs and comments, reply (with your saved replies), and triage with labels and assignments.
  • Run Instagram automations — auto-DM people who comment a keyword, reply to a story, or mention you.
  • Get answers — search Planoly's help center and check your plan and billing.

See docs/examples.md for example prompts and workflows.

Getting started

Claude Code

claude mcp add --transport http planoly https://mcp.planoly.com/mcp

Claude (claude.ai and Claude Desktop)

Go to Settings → Connectors → Add custom connector and enter:

https://mcp.planoly.com/mcp

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "planoly": {
      "url": "https://mcp.planoly.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"planoly","type":"http","url":"https://mcp.planoly.com/mcp"}'

Other clients (stdio-only)

For clients that only support local stdio servers, bridge with mcp-remote:

{
  "mcpServers": {
    "planoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.planoly.com/mcp"]
    }
  }
}

On first use, your client opens a browser window to sign in to Planoly and approve access. If the bridge's auth state gets stuck, clear it with rm -rf ~/.mcp-auth and reconnect.

Authentication

The server uses the standard MCP authorization flow — OAuth 2.1 authorization code with refresh tokens, discovered automatically by the client:

  • Protected resource metadata: https://mcp.planoly.com/.well-known/oauth-protected-resource/mcp
  • Authorization server: https://app.planoly.com/api/auth
  • Scopes: openid, profile, email, offline_access

Tokens are scoped to your Planoly user. Tools that operate on a workspace take a workspaceId and enforce workspace membership on every call — start with list_workspaces to see what you can access.

Full details in docs/authentication.md.

Tools

52 tools, summarized below; parameter-level detail lives in docs/tools.md.

Help, workspaces & billing

ToolDescription
search_help / get_help_articleSearch and read Planoly's help center.
list_workspacesList the workspaces your account can access, and whether each includes the inbox.
list_workspace_membersList the people in a workspace.
get_account_billingYour plan, renewal, trial, limits, and recent payments (read-only).

Channels

ToolDescription
list_channelsList a workspace's connected channels, whether they work, and whether they auto-publish.
list_pinterest_boardsList the boards on the connected Pinterest account.

Posts & scheduling

ToolDescription
create_postCreate one post group across one or more channels, with shared or per-platform caption/media and platform settings. Optionally schedule it.
list_post_groupsList posts (drafts, scheduled, published, failed) with captions, schedule, media, and why a post failed.
update_postEdit a post — caption, media, first comment, format, and per-platform settings.
set_post_group_scheduleSchedule, reschedule, schedule at the next Instagram Best Time slot, or revert to draft.
delete_post_groupDelete a draft or scheduled post group.

Instagram tagging & sounds

ToolDescription
search_instagram_locationsSearch places to tag.
search_instagram_productsSearch a connected Instagram Shop catalog for product tags.
search_instagram_audioSearch or browse Instagram's audio catalog for reel sounds.
list_tiktok_trending_soundsBrowse TikTok Commercial Music Library trending sounds.

Media library & assets

ToolDescription
list_media_libraryBrowse and search photos, videos, carousels, notes, bookmarks, and folders.
get_media_previewReturn an inline thumbnail so any client can see an asset.
create_media_library_folderCreate a folder (optionally nested).
create_media_library_itemSave media, a note, or a bookmark into the library.
update_media_library_itemEdit an entry or move it to another folder.
delete_media_library_itemRemove an entry (folders cascade; assets and posts are untouched).
create_asset_from_urlImport an image/video from a supported source (Instagram/Facebook, Planoly, Canva, Higgsfield, DALL·E).
request_asset_upload / confirm_asset_uploadSigned-URL upload for clients that can run code.

Analytics & research

ToolDescription
get_instagram_analyticsInstagram account analytics — growth, reach, interactions, audience.
list_post_performancePublished Instagram posts ranked by the metric you choose.
get_tiktok_analyticsTikTok account analytics, demographics, and recent posts.
get_linkedin_analyticsLinkedIn page or profile analytics and recent posts.
get_pinterest_analyticsPinterest analytics, top pins, and recent pins.
get_instagram_account_postsA public Instagram Business/Creator account's recent posts, for research.
create_post_report_share_linkA shareable, read-only post-performance report link (expires in 14 days).

Brand voice

ToolDescription
get_brand_voiceRead how the brand writes, plus its look and strategy.
request_brand_voice_buildLearn the brand voice from the user's own posts (read-only; the user approves the result).
save_brand_voiceApprove, restore, or add notes, look, or strategy to the brand voice.
forget_brand_voiceDelete the brand voice (restorable).

Inbox

ToolDescription
list_inbox_conversations / search_inbox_conversationsList or search Instagram DMs and comment threads.
get_inbox_conversationRead one conversation.
send_inbox_replyReply by DM, public comment, or private reply.
update_inbox_conversationMark read/unread, close/reopen, assign, and label conversations in bulk.
list_saved_repliesList saved replies to send again.
list_inbox_labels / create_inbox_label / update_inbox_label / delete_inbox_labelManage inbox labels.

Instagram automations

ToolDescription
list_automations / get_automationList or read keyword, story-reply, DM, and mention auto-replies.
create_automation / update_automationCreate (saved paused) or change an automation.
set_automation_enabledTurn an automation on or pause it.
delete_automationDelete an automation permanently.

How media gets into posts

The model never carries media bytes through inference. Media reaches a post by assetId, from one of three sources:

  1. Existing media — take an assetId from list_media_library or from another post via list_post_groups.
  2. From a URL — create_asset_from_url has the server fetch it (allowlisted hosts only).
  3. Local bytes — request_asset_upload → HTTP PUT the bytes → confirm_asset_upload, for clients with a code-execution sandbox.

Details and constraints in docs/media.md.

Validation & plan requirements

Posts are validated against each platform's rules (caption length, media count/type, aspect ratio, video duration) the same way the Planoly app validates them — errors come back at tool-call time with the exact violation, not at publish time.

Some tools map to Planoly premium features and require a paid workspace — including the media library, analytics, TikTok trending sounds, product tagging, and the inbox. When a tool requires an upgrade, the error includes a link to the pricing page. On the free plan, new posts count against a monthly post allowance.

Tools that send to real people — send_inbox_reply and turning on an automation — act on Instagram immediately. Their descriptions tell the assistant to confirm the exact action with you first.

Documentation

Support & security

The server implementation is not open source; this repository tracks the public documentation and MCP registry metadata (server.json) for the hosted service.