Is there an MCP server for Buffer?

Yes. Agent Planners runs a hosted MCP server at https://www.agentplanners.com/api/mcp that gives Claude, ChatGPT, Codex and other MCP clients 14 Buffer read tools and 20 write tools. Sign in with OAuth or an API key. Writes follow your approval settings; changes you can't take back wait for a person unless an admin exempts a key.

MCP

Buffer MCP server: drafts, scheduling and post metrics in Claude, Codex or Cursor

TL;DR

Buffer reaches Claude, Codex or Cursor through the Agent Planners MCP endpoint with 14 reads and 20 writes. Drafts, ideas, notes and tags follow the key's write mode; scheduling, posting now, changing a scheduled post and deleting a post are held for a person on every key mode. Text over a network's limit is refused, never cut.

What this setup adds

Calling Buffer's API yourselfAgent Planners MCP
Sign-inYour API key in each clientOne key pasted on the Buffer card, stored encrypted
Text limitsBuffer refuses or the network cutsEach network's limit and counting rule checked first; over-limit text refused, never cut
PublishingWhatever you sendScheduling and posting now held for a person; a channel also connected directly is publishable only through that connection
Other platformsBuffer onlyYour ads, analytics and direct social connections on the same endpoint

How to configure it

  1. 1Connect Buffer with an API key on its card on Integrations.
  2. 2Create a key in API & MCP: tools:read for reading, add tools:write for changes. To keep a key to Buffer, choose Only these platforms → Buffer.
  3. 3Add the server to your client with one of the snippets below, run describe_permissions, then buffer__list_channels.
bash
# Claude Code
claude mcp add --transport http agent-planners https://www.agentplanners.com/api/mcp \
  --header "Authorization: Bearer $AGENTPLANNERS_API_KEY"

# Codex (signs in with OAuth in the browser)
codex mcp add agent-planners --url https://www.agentplanners.com/api/mcp

# Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "agent-planners": { "url": "https://www.agentplanners.com/api/mcp", "headers": { "Authorization": "Bearer ${env:AGENTPLANNERS_API_KEY}" } } } }
Every client's setup, including OAuth sign-in without a key: MCP setup guide.

The Buffer tools

ToolKindWhat it does
buffer__list_organizationsReadThe Buffer organizations the connected key reaches (id, name, channel count, plan limits: channels, ideas, scheduled posts, tags) and the key's rate-limit windows left (15 min / 24 h / 30 days, shared by every key and…
buffer__list_channelsReadThe channels of a Buffer organization (connected social profiles): id, service (twitter, linkedin, bluesky, instagram, facebook, threads, mastodon, tiktok, youtube, pinterest, googlebusiness, substack), type (profile …
buffer__get_channelReadONE channel (the selected one, or channelId): the fields list_channels returns plus Mastodon's server limit.
buffer__list_postsReadPosts of the selected channel(s), newest first (cursor-paged; truncated + nextCursor when more exist): id, status (draft | needs_approval | scheduled | sending | sent | error), dueAt / sentAt, text, share mode, exte…
buffer__get_postReadONE post by id (status, text, times, media, tags, error, the actions this key may take on it).
buffer__post_metricsReadPerformance of ONE sent post as Buffer normalizes it (reactions, comments, reposts, shares, impressions, reach, views, clicks, engagementRate % …) with metricsUpdatedAt — refreshed once a day, so up to ~24 h behind; a…
buffer__aggregate_metricsReadPost metrics summed over a window (postCount, reactions, comments always; richer metrics only when EVERY channel in the filter reports them).
buffer__list_ideasReadThe organization's ideas (content backlog not tied to a channel): id, title, text, target date, services, created / updated.
buffer__list_tagsReadThe organization's tags (id, name, color, locked — a locked tag cannot be renamed).
buffer__list_content_draftsReadThe organization's content items (channel-less drafts and multi-channel items): id, title, target date (a planning aid, never a schedule), the draft text while it is a draft.
buffer__list_notesReadThe team notes on a post or a channel-less draft, newest first.
buffer__get_limitsReadWhat may still be posted: each channel's daily posting limit at a time (X: the busiest rolling 24 h; others: the channel's local day) with scheduled / sent counts, the organization's plan limits (scheduled posts, idea…
buffer__character_limitsReadThe text limit of a channel's network and how Buffer counts it (UTF-16; X weighted with URLs 23; LinkedIn URLs 24; Instagram line breaks 2; Bluesky graphemes; Mastodon the server's limit), first-comment and title limi…
buffer__getReadANY Buffer GraphQL READ in Buffer's own format: { query (a query document — account, channels, channel, posts, post, ideas, tagsV2, tag, contentItems, contentItem, collaborationNotes, dailyPostingLimits, aggregatedPos…
buffer__create_draftWriteA DRAFT post on the selected channel (createPost saveToDraft:true — status draft, never published until someone schedules it): { accountId? (a connected Buffer channel; optional when the workspace has one), text, medi…
buffer__update_draftWriteChange a DRAFT post (read first — anything that is not a draft is refused here: update_post): { postId, text?, media? (replaces), metadata?, tagIds? }.
buffer__delete_draftWriteDelete a DRAFT post (read first; a scheduled or sent post is delete_post and waits for a person): { postId }.
buffer__create_ideaWriteSave an idea in the organization's backlog (no channel, never published): { organizationId?, title?, text, services? (["twitter", "linkedin" …] — a label only), date? (a planning date) }.
buffer__create_content_draftWriteA channel-less draft (a content item) in the organization — no channel, no network rules, never published until promoted in Buffer: { organizationId?, text, title?, targetDate? (a planning aid only), media?, tagIds? }.
buffer__update_content_draftWriteReplace a channel-less draft's content in full (only while it is still a draft): { contentItemId, text, media?, title?, targetDate? }.
buffer__delete_content_draftWriteDelete a channel-less draft (read first — an item that already holds channel posts is refused here; it is delete_post per post). { contentItemId }.
buffer__set_post_tagsWriteAdd / remove tags on a post (read first; nothing else about the post changes): { postId, add? [tagId], remove? [tagId] }.
buffer__create_tagWriteA tag in the organization: { organizationId?, name (1–100, unique, case-sensitive), color (#RRGGBB) }.
buffer__update_tagWriteRename / recolor a tag (read first; Buffer replaces BOTH, so the one not named keeps its value; a locked tag cannot be edited): { tagId, name?, color? }.
buffer__create_noteWriteA team note on a post or channel-less draft (never published): { postId | contentItemId, text }.
buffer__update_noteWriteReplace a note's text: { noteId, text }.
buffer__delete_noteWriteDelete a note (permanent): { noteId }.
buffer__schedule_postWrite — always a personSchedule a post on the selected channel — a new one { accountId? (a connected Buffer channel; optional when the workspace has one), text, media? ([{ url, type?: image | video | document, title?, thumbnailUrl? (documen…
buffer__share_nowWrite — always a personPublish NOW on the selected channel — a new post { accountId? (a connected Buffer channel; optional when the workspace has one), text, media?, metadata? } or an existing draft / queued post { postId }; projectId?, pro…
buffer__update_postWrite — always a personChange a scheduled / queued post (what will go out, or when): { postId, text?, media?, metadata?, dueAt?, tagIds? }.
buffer__move_in_queueWrite — always a personMove a queued post to the top (next slot) or bottom of its channel's queue: { postId, position: top | bottom }.
buffer__delete_postWrite — always a personDelete a scheduled or sent post from Buffer: { postId }.
buffer__delete_tagWrite — always a personDelete a tag — it is removed from every post, idea and content item of the organization and cannot be undone: { tagId }.
buffer__mutateWrite — always a personONE Buffer mutation in Buffer's own format, for what the typed tools do not cover (content items across channels, post templates, snippets, promoting a draft): { mutation (one documented mutation field), variables?, a…

What waits for a person, whatever the key allows

  • Scheduling a post (a time, the queue or the next slot) and posting now.
  • Changing or moving a scheduled post, deleting a post and deleting a tag.
  • A gateway mutation (buffer__mutate).
A dry run of a schedule or post-now returns the exact request and sends nothing. Rate limits on the plan we measured: 150 requests per 15 minutes, 600 a day, 3,000 in 30 days. Reads and drafts were run against a real Buffer account; nothing was scheduled or published live. A post made with projectId / projectItemId (or by a project task) is linked to that plan item — see Projects. Buffer setup guide · Buffer platform page · Buffer MCP server

Frequently asked questions

How do I connect Claude to Buffer?
Paste a Buffer API key (Buffer → Settings → API) on the Buffer card on Integrations, create an Agent Planners key in API & MCP, add the MCP server to Claude and call buffer__list_channels.
Can an MCP client publish through Buffer on its own?
No. Scheduling and posting now are held for a person on every key mode.

About this platform

Put a human-approved agent on your ad ops

Start free — 2,500 credits a month, no credit card. Reads run at once; by default every write waits for your approval.

Related reading