Skip to main content
Glama
Hootsuite MCP Server

Hootsuite MCP Server

Hootsuite MCP Server

Hootsuite Mcp Server

GitHub stars GitHub forks GitHub watchers

License Issues Pull Requests Last Commit

Python MCP

Commit Activity Code Size Contributors

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

Overview

Social media management platform

Related MCP server: Sooshie MCP Server

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

Available Tools

5 tools
create_postB

Create and schedule a social media post on Hootsuite.

Args: text: The content of the post. social_profile_ids: List of social profile IDs to post to. scheduled_send_time: Optional ISO 8601 datetime for scheduling.

Inputs: text (required), social_profile_ids (required), scheduled_send_time. Returns: result

delete_postB

Delete a scheduled or draft post from Hootsuite.

Args: post_id: The ID of the post to delete.

Inputs: post_id (required). Returns: result

get_analyticsB

Get analytics data for social profiles.

Args: profile_ids: List of profile IDs to get analytics for. start_date: Start date in ISO format (YYYY-MM-DD). end_date: End date in ISO format (YYYY-MM-DD).

Inputs: end_date (required), start_date (required), profile_ids (required). Returns: result

get_postsB

Get scheduled and published posts from Hootsuite.

Args: limit: Maximum number of posts to retrieve (default: 20). state: Optional filter by state (scheduled, published, draft).

Inputs: limit, state. Returns: result

get_social_profilesA

Get the list of social media profiles connected to Hootsuite.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a unique purpose: creating posts, listing profiles, listing posts, deleting posts, and fetching analytics. No overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern: create_post, get_social_profiles, get_posts, delete_post, get_analytics.

    Tool Count5/5

    5 tools is well-scoped for a social media posting server, covering essential CRUD and analytics without bloat.

    Completeness4/5

    Covers create, read, delete, and analytics, but lacks an update post tool for editing. Minor gap but core workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Official MCP server for PostEverywhere (posteverywhere.ai/social-media-scheduler). Let Claude, ChatGPT, Cursor or any MCP client schedule and publish posts to 13 platforms: Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord, WordPress and Google Business Profile. 40 tools: best-time scheduling, threads, cross-posting, campaigns, analytics.
      33
      241 npm
      7
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage social media through Sooshie, including scheduling posts, generating captions, managing accounts, and more via natural language.
      101 npm
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.
      7
      36 npm
      MIT