sprout-social-mcp 0.1.2

MCP server for managing Sprout Social via Claude

Sprout Social MCP Server

An MCP (Model Context Protocol) server that connects Claude to the Sprout Social API for managing social media posts, profiles, and analytics.

Features

Core Workflow

• get_customer_id — Get your Sprout Social customer ID
• list_profiles — List all connected social profiles (LinkedIn, X/Twitter, Instagram, Facebook, etc.)
• create_post — Create draft posts with optional scheduling, media, and tags
• get_post — Get details and status of a specific post

Media & Metadata

• upload_media — Upload images/videos via public URL
• list_tags — List available tags for organizing posts
• list_users — List all users on the account

Analytics

• get_profile_analytics — Aggregated analytics for social profiles over a date range
• get_post_analytics — Per-post performance metrics over a date range

Prerequisites

• A Sprout Social API token (developer docs)
• Claude Desktop or Claude Code
• For npx: Node.js 18+ (recommended for most users)
• For uvx: Python 3.10+
• For clone method: Python 3.10+ and git

Installation

Choose one of the following installation methods:

Option 1: npx (Recommended)

No installation required! Just add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "sprout-social": {
      "command": "npx",
      "args": ["-y", "@kodowjam/sprout-social-mcp"],
      "env": {
        "SPROUT_API_TOKEN": "your_sprout_social_api_token_here",
        "SPROUT_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

For Claude Code:

claude mcp add sprout-social -- npx -y @kodowjam/sprout-social-mcp

Then set the environment variables in your shell or MCP config.

Don't know your customer ID? You can use the get_customer_id tool after connecting to find it.

Option 2: uvx / PyPI

No installation required! Add this to your Claude Desktop config:

{
  "mcpServers": {
    "sprout-social": {
      "command": "uvx",
      "args": ["sprout-social-mcp"],
      "env": {
        "SPROUT_API_TOKEN": "your_sprout_social_api_token_here",
        "SPROUT_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

For Claude Code:

claude mcp add sprout-social -- uvx sprout-social-mcp

Then set the environment variables in your shell or MCP config.

Option 3: Clone & Install

For development or local customization:

1. Clone and install:

git clone https://github.com/kodowjam/sprout-social-mcp-server.git
cd sprout-social-mcp-server
pip install .

2. Configure environment:

cp .env.example .env

Edit .env with your credentials:

SPROUT_API_TOKEN=your_sprout_social_api_token_here
SPROUT_CUSTOMER_ID=your_customer_id_here

3. Connect to Claude Desktop:

{
  "mcpServers": {
    "sprout-social": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "/absolute/path/to/sprout-social-mcp-server"
    }
  }
}

For Claude Code:

claude mcp add sprout-social -- python /absolute/path/to/sprout-social-mcp-server/server.py

Restart Claude Desktop to load the server.

Tools Reference

Tool	Description	Key Parameters
get_customer_id	Get your Sprout customer ID	—
list_profiles	List connected social profiles with IDs, networks, and group IDs	—
create_post	Create a draft post, optionally scheduled	profile_ids, text, scheduled_at, media_ids, tag_ids
get_post	Get post details by ID	post_id
upload_media	Upload media from a public URL (expires 24hr unless attached to a post)	url
list_tags	List available tags for organizing posts	—
list_users	List all account users	—
get_profile_analytics	Aggregated profile metrics over a date range	profile_ids, start_date, end_date, metrics
get_post_analytics	Per-post metrics over a date range	profile_ids, start_date, end_date, metrics

Getting Your API Token

1. Log in to Sprout Social
2. Navigate to Settings > API (or contact your Sprout admin for API access)
3. Generate a new API token
4. See the Sprout Social API docs for details

License

MIT