@Damusix/Buffer

An MCP (Model Context Protocol) server for the Buffer social media API. Manage posts, channels, organizations, and ideas through any MCP-compatible LLM client.

Install

pnpm add @damusix/buffer-mcp

Or run directly with npx:

npx @damusix/buffer-mcp

Configuration

Variable	Required	Description
BUFFER_ACCESS_TOKEN	Yes	Your Buffer API access token. Get one from Buffer Developer Settings.

The server will exit immediately if BUFFER_ACCESS_TOKEN is not set.

Usage with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
    "mcpServers": {
        "buffer": {
            "command": "npx",
            "args": ["@damusix/buffer-mcp"],
            "env": {
                "BUFFER_ACCESS_TOKEN": "your-token-here"
            }
        }
    }
}

Usage with Claude Code

claude mcp add buffer -e BUFFER_ACCESS_TOKEN=your-token-here -- npx @damusix/buffer-mcp

Usage with Other Clients

For Cursor, Windsurf, or any other MCP-compatible client, add @damusix/buffer-mcp as a stdio MCP server with BUFFER_ACCESS_TOKEN set in the environment. Consult your client's documentation for the exact configuration format.

Tools

use_buffer_api

Execute a Buffer API action. Takes an action name and an optional payload object.

Available actions:

Action	Category	Description
listOrganizations	query	List all organizations on the account
listChannels	query	List channels for an organization
getChannel	query	Get a single channel by ID
listPosts	query	List posts with pagination and filters
getPost	query	Get a single post by ID
getDailyPostingLimits	query	Get daily posting limits for channels
createPost	mutation	Create a new post (draft, queued, or scheduled)
deletePost	mutation	Delete a post by ID
createIdea	mutation	Create a new idea in an organization

Examples:

List organizations:

{
    "action": "listOrganizations"
}

List posts with pagination:

{
    "action": "listPosts",
    "payload": {
        "organizationId": "abc123",
        "first": 10,
        "after": "cursor-string"
    }
}

Create a draft post:

{
    "action": "createPost",
    "payload": {
        "channelId": "abc123",
        "text": "Hello world!",
        "schedulingType": "automatic",
        "mode": "addToQueue",
        "saveToDraft": true
    }
}

buffer_api_help

Get help on available actions. Takes an optional action name or category filter.

List all actions:

{}

List only query actions:

{
    "category": "query"
}

Get detailed help for a specific action:

{
    "action": "createPost"
}

Development

pnpm install
pnpm test
pnpm run build

License

MIT