Skip to content

ahernan2/buffer-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors