Skip to main content
Glama
buffer-mcp

buffer-mcp

by ahernan2

Buffer MCP Server

MCP server for Buffer social media management — create, schedule, and manage posts across all your connected social platforms via Claude.

Built on Buffer's new GraphQL API (public beta, Feb 2026).

Setup

Requirements: Node.js >= 20

npm install
npm run build

Related MCP server: buffer-mcp-server

Buffer Access Token

  1. Go to publish.buffer.com/settings/api

  2. Click "Generate API Key"

  3. Copy your access token

Environment Variables

Variable

Required

Description

BUFFER_ACCESS_TOKEN

Yes

Your Buffer API access token

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "buffer": {
      "command": "node",
      "args": ["/path/to/buffer-mcp/dist/index.js"],
      "env": {
        "BUFFER_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Usage with Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "buffer": {
      "command": "node",
      "args": ["/path/to/buffer-mcp/dist/index.js"],
      "env": {
        "BUFFER_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Tools (7)

Tool

Description

account_info

Get account, organizations, and their IDs

channels_list

List all connected social channels for an org

channel_get

Get details for a single channel

posts_list

List posts with filters (status, channel, date range) and pagination

post_get

Get a single post by ID

post_create

Create a post (queue, schedule, publish now, or publish next)

idea_create

Save an idea to the Buffer ideas board

Resources (1)

URI

Description

buffer://info/api

API info, rate limits, supported platforms, limitations

Limitations

  • No edit/delete via API: The beta GraphQL API supports creating posts only. Use the Buffer dashboard to edit or delete.

  • No analytics: Engagement metrics (likes, comments, reach) are not available via API.

  • No DMs: Only public posts are supported.

  • Media via URL only: Attach images/videos by providing a hosted URL. No file upload endpoint yet.

  • Rate limit: 100 requests per 15 minutes per client.

Available Tools

7 tools
account_infoA

Get the authenticated Buffer account: email, name, timezone, connected organizations and their IDs. Call this first to get the organizationId needed by other tools.

Inputs: no named parameters.

channel_getA

Get detailed info for a single channel including posting schedule, metadata, and queue status.

Inputs: channel_id (required).

channels_listA

List all connected social media channels for an organization. Returns channel IDs needed by post_create and posts_list.

Inputs: organization_id (required).

idea_createB

Save an idea to the Buffer ideas board for later use. Ideas can have text, images, tags, and target services.

Inputs: organization_id (required), text, title, services, +1 more.

post_createA

Create a new post on a channel. Use mode to control scheduling: "addToQueue" (default queue), "shareNow" (publish immediately), "shareNext" (next in queue), or "customScheduled" (set dueAt).

Inputs: text (required), channel_id (required), mode, due_at, +4 more.

post_getA

Get a single post by its ID with full details including assets, tags, notes, and allowed actions.

Inputs: post_id (required).

posts_listA

List posts for an organization with optional filters by status, channel, and date range. Supports cursor-based pagination.

Inputs: organization_id (required), after, first, status, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource: account, channels list/detail, posts list/detail/create, and ideas create. There is no ambiguity between list-versus-get or across different resource types.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern (channels_list, channel_get, posts_list, post_create). The only deviation is account_info, which would be more consistent as get_account_info.

    Tool Count5/5

    Seven tools provide a focused scope for Buffer account, channel, post, and idea operations. The count is appropriate and each tool has a clear purpose.

    Completeness4/5

    Core workflows are covered: discover account and channels, list and create posts, and save ideas. Missing update/delete operations for posts and a way to list ideas are minor gaps but do not block primary scheduling workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers