Planoly MCP server
Commit Nov 1, 2026Connect AI assistants to Planoly to plan, create, schedule, and analyze social media content across Instagram, TikTok, YouTube, and more.
Also known as Planoly/planoly-mcp
- Stars
- 1
- Tools
- 38
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 1, 2026
- License
- MIT
What is Planoly MCP?
Planoly connects AI assistants to Planoly to plan, create, schedule, and analyze social media content across Instagram, TikTok, YouTube, and more. It exposes 38 tools, such as list_workspaces, list_workspace_members, get_account_billing.
Summary generated from the project's README
About Planoly MCP server
Social media managers and content creators can manage their entire digital presence through AI assistants using this remote MCP server. By connecting to the Planoly hosted URL via OAuth, users can control content across Instagram, TikTok, YouTube, Pinterest, Facebook, LinkedIn, Threads, and X directly from clients like Claude, Cursor, or VS Code.
The server provides 52 tools to handle everything from creating and scheduling posts with platform-specific overrides to managing a media library. It allows for deep integration with brand identity by learning a specific brand voice from existing posts. Users can also perform advanced tasks such as analyzing performance metrics for TikTok and LinkedIn, managing Instagram DMs and comments through an integrated inbox, and setting up Instagram automations for keyword or mention replies.
Because this is a remote server, there is no local installation required. Access to premium features like the media library, analytics, and the inbox depends on the user's Planoly subscription plan. All media is handled via asset IDs or URLs to ensure efficient processing within the AI client.
What you can do with it
- 1Cross-platform content schedulingCreate a single post group with unique captions and settings for Instagram, TikTok, and Pinterest simultaneously.
- 2Social media performance analysisRetrieve detailed growth and reach metrics for an Instagram account or analyze top performing pins on Pinterest.
- 3Automated community engagementSet up an automation that automatically sends a direct message to users who comment a specific keyword on Instagram.
- 4Brand voice consistencyHave the AI analyze previous posts to learn and replicate a specific brand writing style for new captions.
Written from the project's README. Every use case is checked against a quote from it.
Planoly MCP tools 38
Detected from the READMElist_workspaceslist_workspace_membersget_account_billinglist_channelslist_pinterest_boardscreate_postlist_post_groupsupdate_postset_post_group_scheduledelete_post_groupsearch_instagram_locationssearch_instagram_products
Show all 38 toolsShow fewer tools
search_instagram_audiolist_tiktok_trending_soundslist_media_libraryget_media_previewcreate_media_library_foldercreate_media_library_itemupdate_media_library_itemdelete_media_library_itemcreate_asset_from_urlget_instagram_analyticslist_post_performanceget_tiktok_analyticsget_linkedin_analyticsget_pinterest_analyticsget_instagram_account_postscreate_post_report_share_linkget_brand_voicerequest_brand_voice_buildsave_brand_voiceforget_brand_voiceget_inbox_conversationsend_inbox_replyupdate_inbox_conversationlist_saved_repliesset_automation_enableddelete_automation
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableplanoly/planoly-mcp is public and reachablegithub.com/planoly/planoly-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-01github.com/planoly/planoly-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model38 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPlanoly MCP Server
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
| Tool | Description |
|---|---|
search_help / get_help_article |
Search and read Planoly's help center. |
list_workspaces |
List the workspaces your account can access, and whether each includes the inbox. |
list_workspace_members |
List the people in a workspace. |
get_account_billing |
Your plan, renewal, trial, limits, and recent payments (read-only). |
Channels
| Tool | Description |
|---|---|
list_channels |
List a workspace's connected channels, whether they work, and whether they auto-publish. |
list_pinterest_boards |
List the boards on the connected Pinterest account. |
Posts & scheduling
| Tool | Description |
|---|---|
create_post |
Create one post group across one or more channels, with shared or per-platform caption/media and platform settings. Optionally schedule it. |
list_post_groups |
List posts (drafts, scheduled, published, failed) with captions, schedule, media, and why a post failed. |
update_post |
Edit a post — caption, media, first comment, format, and per-platform settings. |
set_post_group_schedule |
Schedule, reschedule, schedule at the next Instagram Best Time slot, or revert to draft. |
delete_post_group |
Delete a draft or scheduled post group. |
Instagram tagging & sounds
| Tool | Description |
|---|---|
search_instagram_locations |
Search places to tag. |
search_instagram_products |
Search a connected Instagram Shop catalog for product tags. |
search_instagram_audio |
Search or browse Instagram's audio catalog for reel sounds. |
list_tiktok_trending_sounds |
Browse TikTok Commercial Music Library trending sounds. |
Media library & assets
| Tool | Description |
|---|---|
list_media_library |
Browse and search photos, videos, carousels, notes, bookmarks, and folders. |
get_media_preview |
Return an inline thumbnail so any client can see an asset. |
create_media_library_folder |
Create a folder (optionally nested). |
create_media_library_item |
Save media, a note, or a bookmark into the library. |
update_media_library_item |
Edit an entry or move it to another folder. |
delete_media_library_item |
Remove an entry (folders cascade; assets and posts are untouched). |
create_asset_from_url |
Import an image/video from a supported source (Instagram/Facebook, Planoly, Canva, Higgsfield, DALL·E). |
request_asset_upload / confirm_asset_upload |
Signed-URL upload for clients that can run code. |
Analytics & research
| Tool | Description |
|---|---|
get_instagram_analytics |
Instagram account analytics — growth, reach, interactions, audience. |
list_post_performance |
Published Instagram posts ranked by the metric you choose. |
get_tiktok_analytics |
TikTok account analytics, demographics, and recent posts. |
get_linkedin_analytics |
LinkedIn page or profile analytics and recent posts. |
get_pinterest_analytics |
Pinterest analytics, top pins, and recent pins. |
get_instagram_account_posts |
A public Instagram Business/Creator account's recent posts, for research. |
create_post_report_share_link |
A shareable, read-only post-performance report link (expires in 14 days). |
Brand voice
| Tool | Description |
|---|---|
get_brand_voice |
Read how the brand writes, plus its look and strategy. |
request_brand_voice_build |
Learn the brand voice from the user's own posts (read-only; the user approves the result). |
save_brand_voice |
Approve, restore, or add notes, look, or strategy to the brand voice. |
forget_brand_voice |
Delete the brand voice (restorable). |
Inbox
| Tool | Description |
|---|---|
list_inbox_conversations / search_inbox_conversations |
List or search Instagram DMs and comment threads. |
get_inbox_conversation |
Read one conversation. |
send_inbox_reply |
Reply by DM, public comment, or private reply. |
update_inbox_conversation |
Mark read/unread, close/reopen, assign, and label conversations in bulk. |
list_saved_replies |
List saved replies to send again. |
list_inbox_labels / create_inbox_label / update_inbox_label / delete_inbox_label |
Manage inbox labels. |
Instagram automations
| Tool | Description |
|---|---|
list_automations / get_automation |
List or read keyword, story-reply, DM, and mention auto-replies. |
create_automation / update_automation |
Create (saved paused) or change an automation. |
set_automation_enabled |
Turn an automation on or pause it. |
delete_automation |
Delete 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:
- Existing media — take an
assetIdfromlist_media_libraryor from another post vialist_post_groups. - From a URL —
create_asset_from_urlhas the server fetch it (allowlisted hosts only). - Local bytes —
request_asset_upload→ HTTPPUTthe 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
- Tool reference — every tool, its parameters, and behavior
- Authentication — the OAuth flow, token model, resetting auth state
- Media handling — how assets get in and out
- Example prompts — workflows to try
- Troubleshooting — common errors and fixes
- Changelog
Support & security
- Product and account help: Planoly help center · see SUPPORT.md
- MCP server bugs and feature requests: issues
- Vulnerabilities: report privately per SECURITY.md
The server implementation is not open source; this repository tracks the public documentation and MCP registry metadata (server.json) for the hosted service.
Planoly MCP questions
What tools does Planoly MCP provide?
It exposes 38 tools, including list_workspaces, list_workspace_members, get_account_billing, list_channels, list_pinterest_boards.
Can I use this to manage my Instagram DMs?
Yes, you can read, search, and reply to Instagram DMs and comments through the inbox tools.