How do I use sprout-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@sprout-mcp Show me the engagement analytics for my social profiles" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

sprout-mcp

An MCP (Model Context Protocol) server that wraps the Sprout Social Public API, letting Claude and other MCP clients interact with your Sprout Social account directly.

Tools

Tool	Description
`list_customers`	List all customers/accounts accessible with your API token
`list_profiles`	List all social profiles for a customer
`list_tags`	List all message tags
`list_groups`	List all profile groups
`list_users`	List all active users
`list_teams`	List all teams
`get_profile_analytics`	Get aggregated analytics by profile (impressions, engagements, etc.)
`get_post_analytics`	Get analytics for individual posts
`get_messages`	Retrieve inbound inbox messages (Smart Inbox) — for outbound post counts use `get_post_analytics`
`create_post`	Create a draft or scheduled post
`get_publishing_post`	Retrieve a specific publishing post by ID

Setup

Prerequisites

Python 3.11+
uv (recommended) or pip
A Sprout Social account with API access

Install

git clone https://github.com/jmeserve/sprout-mcp.git cd sprout-mcp uv sync

Configure

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

SPROUT_API_TOKEN=your_api_token_here SPROUT_CUSTOMER_ID=your_customer_id_here

SPROUT_API_TOKEN — Generate at Sprout Social → Settings → API → OAuth tokens
SPROUT_CUSTOMER_ID — Found in your Sprout Social account URL or via the list_customers tool

Add to Claude Code

Add to your ~/.claude.json MCP servers config:

{ "mcpServers": { "sprout-social": { "command": "uv", "args": ["--directory", "/path/to/sprout-mcp", "run", "sprout-mcp"], "env": { "SPROUT_API_TOKEN": "your_api_token_here", "SPROUT_CUSTOMER_ID": "your_customer_id_here" } } } }

Add to Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "sprout-social": { "command": "uv", "args": ["--directory", "/path/to/sprout-mcp", "run", "sprout-mcp"], "env": { "SPROUT_API_TOKEN": "your_api_token_here", "SPROUT_CUSTOMER_ID": "your_customer_id_here" } } } }