A Model Context Protocol (MCP) server for integrating Hootsuite with GenAI applications.

Overview

Social media management platform

Features

• Comprehensive Hootsuite API coverage
• Multiple authentication methods
• Enterprise-ready with rate limiting
• Full error handling and retry logic
• Async support for better performance

Installation

pip install hootsuite-mcp-server

Or install from source:

git clone https://github.com/asklokesh/hootsuite-mcp-server.git
cd hootsuite-mcp-server
pip install -e .

Configuration

Create a .env file in your project root with your Hootsuite API credentials:

# Option 1: OAuth Access Token (recommended)
HOOTSUITE_ACCESS_TOKEN=your_access_token_here

# Option 2: API Key and Secret
HOOTSUITE_API_KEY=your_api_key_here
HOOTSUITE_API_SECRET=your_api_secret_here

See .env.example for all available configuration options.

Quick Start

Running the MCP Server

# Using the command line entry point
hootsuite-mcp

# Or using Python
python -m hootsuite_mcp.server

Using as a Library

from hootsuite_mcp import mcp

# `mcp` is a FastMCP instance with tools pre-registered.
# Run the stdio transport in-process:
if __name__ == "__main__":
    mcp.run()

Requirements

• Python 3.10 or newer
• MCP SDK 1.27+ (installed automatically via pip install -e .)

Available Tools

The MCP server provides the following tools:

1. create_post - Create and schedule social media posts
2. get_social_profiles - Get connected social media profiles
3. get_posts - Retrieve scheduled and published posts
4. delete_post - Delete posts by ID
5. get_analytics - Get analytics data for profiles

Development

See DEVELOPER.md for detailed development documentation.

Running Tests

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Run with coverage
pytest tests/ -v --cov=src --cov-report=term

Validation

Run the validation script to check the installation:

python validate.py

CI/CD

The project uses GitHub Actions for continuous integration:

• Quick Test - Runs on every push/PR for fast feedback
• Full CI - Comprehensive testing across multiple Python versions and OSes

License

MIT License - see LICENSE file for details