Buffer

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

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.