productivity
Sprout Social CLI for AI Agents
Use the Sprout Social CLI from KosmoKrator to call Sprout Social tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.Sprout Social CLI Setup
Sprout Social can be configured headlessly with `kosmokrator integrations:configure sproutsocial`.
# 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 sproutsocial --set access_token="$SPROUTSOCIAL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor sproutsocial --json
kosmokrator integrations:status --json Credentials
Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.
| Key | Env var | Type | Required | Label |
|---|---|---|---|---|
access_token | SPROUTSOCIAL_ACCESS_TOKEN | Secret secret | yes | Access Token |
url | SPROUTSOCIAL_URL | URL url | no | API Base URL |
Command Patterns
The generic command is stable across every integration. The provider shortcut is shorter for humans.
kosmo integrations:call sproutsocial.sproutsocial_list_profiles '{}' --json kosmo integrations:sproutsocial sproutsocial_list_profiles '{}' --json Discovery
These commands return structured output for coding agents that need to inspect capabilities before choosing a function.
kosmo integrations:docs sproutsocial --json
kosmo integrations:docs sproutsocial.sproutsocial_list_profiles --json
kosmo integrations:schema sproutsocial.sproutsocial_list_profiles --json
kosmo integrations:search "Sprout Social" --json
kosmo integrations:list --json Automation Contexts
The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.
CLI Functions
Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.
sproutsocial.sproutsocial_list_profiles
List all social media profiles connected to the Sprout Social account. Returns profile IDs, service types (e.g., Twitter, Facebook, LinkedIn), and display names.
read - Parameters
- none
kosmo integrations:call sproutsocial.sproutsocial_list_profiles '{}' --json kosmo integrations:sproutsocial sproutsocial_list_profiles '{}' --json sproutsocial.sproutsocial_get_profile
Get details of a specific social media profile in Sprout Social by its ID. Returns profile service type, display name, and account metadata.
read - Parameters
- profileId
kosmo integrations:call sproutsocial.sproutsocial_get_profile '{"profileId":"example_profileId"}' --json kosmo integrations:sproutsocial sproutsocial_get_profile '{"profileId":"example_profileId"}' --json sproutsocial.sproutsocial_list_posts
List posts across social profiles in Sprout Social. Optionally filter by status (sent, scheduled, draft) and paginate results.
read - Parameters
- count, page, status
kosmo integrations:call sproutsocial.sproutsocial_list_posts '{"count":1,"page":1,"status":"example_status"}' --json kosmo integrations:sproutsocial sproutsocial_list_posts '{"count":1,"page":1,"status":"example_status"}' --json sproutsocial.sproutsocial_create_post
Create and schedule a new social media post in Sprout Social. Provide the text content, target profile IDs, and optionally a scheduled time or media attachments.
write - Parameters
- text, profileIds, scheduledAt, media
kosmo integrations:call sproutsocial.sproutsocial_create_post '{"text":"example_text","profileIds":"example_profileIds","scheduledAt":"example_scheduledAt","media":"example_media"}' --json kosmo integrations:sproutsocial sproutsocial_create_post '{"text":"example_text","profileIds":"example_profileIds","scheduledAt":"example_scheduledAt","media":"example_media"}' --json sproutsocial.sproutsocial_list_messages
List inbox messages and conversations in Sprout Social. Returns message IDs, sender info, and content snippets with pagination support.
read - Parameters
- count, page
kosmo integrations:call sproutsocial.sproutsocial_list_messages '{"count":1,"page":1}' --json kosmo integrations:sproutsocial sproutsocial_list_messages '{"count":1,"page":1}' --json sproutsocial.sproutsocial_get_message
Get details of a specific message in Sprout Social by its ID. Returns sender info, message content, attachments, and conversation metadata.
read - Parameters
- messageId
kosmo integrations:call sproutsocial.sproutsocial_get_message '{"messageId":"example_messageId"}' --json kosmo integrations:sproutsocial sproutsocial_get_message '{"messageId":"example_messageId"}' --json sproutsocial.sproutsocial_get_current_user
Get the currently authenticated Sprout Social user profile. Returns the user name, email, and account info.
read - Parameters
- none
kosmo integrations:call sproutsocial.sproutsocial_get_current_user '{}' --json kosmo integrations:sproutsocial sproutsocial_get_current_user '{}' --json Function Schemas
Use these parameter tables when building CLI payloads without calling integrations:schema first.
sproutsocial.sproutsocial_list_profiles 0 parameters
kosmo integrations:schema sproutsocial.sproutsocial_list_profiles --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
sproutsocial.sproutsocial_get_profile 1 parameters
kosmo integrations:schema sproutsocial.sproutsocial_get_profile --json | Parameter | Type | Required | Description |
|---|---|---|---|
profileId | string | yes | The social profile ID to retrieve. |
sproutsocial.sproutsocial_list_posts 3 parameters
kosmo integrations:schema sproutsocial.sproutsocial_list_posts --json | Parameter | Type | Required | Description |
|---|---|---|---|
count | integer | no | Number of posts to return per page. |
page | integer | no | Page number for pagination. |
status | string | no | Filter by post status: "sent", "scheduled", or "draft". |
sproutsocial.sproutsocial_create_post 4 parameters
kosmo integrations:schema sproutsocial.sproutsocial_create_post --json | Parameter | Type | Required | Description |
|---|---|---|---|
text | string | yes | The text content of the post. |
profileIds | array | yes | Array of Sprout Social profile IDs to publish the post to. |
scheduledAt | string | no | ISO 8601 timestamp for when the post should be sent (e.g., "2025-02-01T09:00:00Z"). |
media | object | no | Media attachments such as photo URL, link, or thumbnail. |
sproutsocial.sproutsocial_list_messages 2 parameters
kosmo integrations:schema sproutsocial.sproutsocial_list_messages --json | Parameter | Type | Required | Description |
|---|---|---|---|
count | integer | no | Number of messages to return per page. |
page | integer | no | Page number for pagination. |
sproutsocial.sproutsocial_get_message 1 parameters
kosmo integrations:schema sproutsocial.sproutsocial_get_message --json | Parameter | Type | Required | Description |
|---|---|---|---|
messageId | string | yes | The message ID to retrieve. |
sproutsocial.sproutsocial_get_current_user 0 parameters
kosmo integrations:schema sproutsocial.sproutsocial_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.