Can I use Buffer as a CLI?

Yes. KosmoKrator exposes a Buffer CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Buffer through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Buffer tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Buffer credentials stored?

Buffer credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Buffer MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

marketing

Buffer CLI for AI Agents

Use the Buffer CLI from KosmoKrator to call Buffer tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 6 read 1 write Manual OAuth token auth

Submit Buffer feedback View package source

Buffer CLI Setup

Buffer can be configured headlessly with `kosmokrator integrations:configure buffer`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure buffer --set access_token="$BUFFER_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor buffer --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`BUFFER_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`BUFFER_URL`	URL `url`	no	API Base URL

Call Buffer Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call buffer.buffer_list_profiles '{}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:buffer buffer_list_profiles '{}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs buffer --json
kosmo integrations:docs buffer.buffer_list_profiles --json
kosmo integrations:schema buffer.buffer_list_profiles --json
kosmo integrations:search "Buffer" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Buffer.

`buffer.buffer_list_profiles`

Read read

List all social media profiles connected to the Buffer account. Returns profile IDs, service types (e.g., Twitter, Facebook, LinkedIn), and display names.

Parameters: none

Generic CLI call

kosmo integrations:call buffer.buffer_list_profiles '{}' --json

Provider shortcut

kosmo integrations:buffer buffer_list_profiles '{}' --json

`buffer.buffer_get_profile`

Read read

Get details of a specific social media profile in Buffer by its ID. Returns profile service type, display name, and account metadata.

Parameters: profileId

Generic CLI call

kosmo integrations:call buffer.buffer_get_profile '{"profileId":"example_profileId"}' --json

Provider shortcut

kosmo integrations:buffer buffer_get_profile '{"profileId":"example_profileId"}' --json

`buffer.buffer_list_pending_updates`

Read read

List scheduled (pending) updates for a Buffer profile. Returns update IDs, text content, scheduled times, and status. Supports pagination.

Parameters: profileId, count, page

Generic CLI call

kosmo integrations:call buffer.buffer_list_pending_updates '{"profileId":"example_profileId","count":1,"page":1}' --json

Provider shortcut

kosmo integrations:buffer buffer_list_pending_updates '{"profileId":"example_profileId","count":1,"page":1}' --json

`buffer.buffer_create_update`

Write write

Create and schedule a new social media update in Buffer. Provide the text content, target profile IDs, and optionally a scheduled time or media attachments.

Parameters: text, profileIds, shorten, now, scheduledAt, media

Generic CLI call

kosmo integrations:call buffer.buffer_create_update '{"text":"example_text","profileIds":"example_profileIds","shorten":true,"now":true,"scheduledAt":"example_scheduledAt","media":"example_media"}' --json

Provider shortcut

kosmo integrations:buffer buffer_create_update '{"text":"example_text","profileIds":"example_profileIds","shorten":true,"now":true,"scheduledAt":"example_scheduledAt","media":"example_media"}' --json

`buffer.buffer_list_sent_updates`

Read read

List already posted (sent) updates for a Buffer profile. Returns update IDs, text content, sent times, and engagement metrics. Supports pagination.

Parameters: profileId, count, page

Generic CLI call

kosmo integrations:call buffer.buffer_list_sent_updates '{"profileId":"example_profileId","count":1,"page":1}' --json

Provider shortcut

kosmo integrations:buffer buffer_list_sent_updates '{"profileId":"example_profileId","count":1,"page":1}' --json

`buffer.buffer_get_update`

Read read

Get details of a specific Buffer update by its ID. Returns the update text, scheduled or sent time, social profiles, media, and delivery status.

Parameters: updateId

Generic CLI call

kosmo integrations:call buffer.buffer_get_update '{"updateId":"example_updateId"}' --json

Provider shortcut

kosmo integrations:buffer buffer_get_update '{"updateId":"example_updateId"}' --json

`buffer.buffer_get_current_user`

Read read

Get the currently authenticated Buffer user profile. Returns the user name, email, and account info.

Parameters: none

Generic CLI call

kosmo integrations:call buffer.buffer_get_current_user '{}' --json

Provider shortcut

kosmo integrations:buffer buffer_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`buffer.buffer_list_profiles`

List all social media profiles connected to the Buffer account. Returns profile IDs, service types (e.g., Twitter, Facebook, LinkedIn), and display names.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_list_profiles --json

Parameter	Type	Required	Description
No parameters.

`buffer.buffer_get_profile`

Get details of a specific social media profile in Buffer by its ID. Returns profile service type, display name, and account metadata.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_get_profile --json

Parameter	Type	Required	Description
`profileId`	string	yes	The social profile ID to retrieve.

`buffer.buffer_list_pending_updates`

List scheduled (pending) updates for a Buffer profile. Returns update IDs, text content, scheduled times, and status. Supports pagination.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_list_pending_updates --json

Parameter	Type	Required	Description
`profileId`	string	yes	The social profile ID to list pending updates for.
`count`	integer	no	Number of updates to return per page.
`page`	integer	no	Page number for pagination.

`buffer.buffer_create_update`

Create and schedule a new social media update in Buffer. Provide the text content, target profile IDs, and optionally a scheduled time or media attachments.

Operation: Write write
Schema command: kosmo integrations:schema buffer.buffer_create_update --json

Parameter	Type	Required	Description
`text`	string	yes	The text content of the update to post.
`profileIds`	array	yes	Array of Buffer profile IDs to publish the update to.
`shorten`	boolean	no	Whether to automatically shorten links (default true).
`now`	boolean	no	Post immediately instead of scheduling (default false).
`scheduledAt`	string	no	ISO 8601 timestamp for when the update should be sent (e.g., "2025-02-01T09:00:00Z").
`media`	object	no	Media attachments such as photo URL, link, or thumbnail.

`buffer.buffer_list_sent_updates`

List already posted (sent) updates for a Buffer profile. Returns update IDs, text content, sent times, and engagement metrics. Supports pagination.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_list_sent_updates --json

Parameter	Type	Required	Description
`profileId`	string	yes	The social profile ID to list sent updates for.
`count`	integer	no	Number of updates to return per page.
`page`	integer	no	Page number for pagination.

`buffer.buffer_get_update`

Get details of a specific Buffer update by its ID. Returns the update text, scheduled or sent time, social profiles, media, and delivery status.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_get_update --json

Parameter	Type	Required	Description
`updateId`	string	yes	The update ID to retrieve.

`buffer.buffer_get_current_user`

Get the currently authenticated Buffer user profile. Returns the user name, email, and account info.

Operation: Read read
Schema command: kosmo integrations:schema buffer.buffer_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.