Skip to main content
Glama

Social MCP

A Model Context Protocol (MCP) server for social media integration, specifically Instagram transcript extraction using AssemblyAI.

Prerequisites

Install uv

On Mac:

brew install uv

On Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation on Windows, add uv to your PATH:

set Path=C:\Users\nntra\.local\bin;%Path%

Environment Setup

  1. Create a .env file in the project root with your AssemblyAI API key:

# Get your API key from: https://www.assemblyai.com/
ASSEMBLYAI_API_KEY=your_assemblyai_api_key_here
  1. Get your AssemblyAI API key:

    • Sign up at AssemblyAI

    • Go to your dashboard and copy your API key

    • Add it to the .env file

Related MCP server: YouTube MCP Server

Claude Desktop Integration

To use this MCP server with Claude Desktop, you need to add it to your Claude Desktop configuration.

  1. Open your Claude Desktop configuration file:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the following configuration to your mcpServers section (replace /path/to/your/social-mcp with the actual path to this project folder):

{
  "mcpServers": {
    "social": {
      "command": "/Users/your-username/.local/bin/uv",
      "args": ["--directory", "/path/to/your/social-mcp", "run", "main.py"]
    }
  },
  "globalShortcut": ""
}

Important: Make sure to replace:

  • /path/to/your/social-mcp with the actual path to where you cloned/downloaded this project

  • /Users/your-username/.local/bin/uv with the correct path to your uv installation (on Windows this would typically be C:\Users\your-username\.local\bin\uv.exe)

  1. Save the file and restart Claude Desktop

Usage

Once configured, the Social MCP server will be available in Claude Desktop. You can use it to:

  • Extract transcripts from Instagram videos/reels by providing Instagram URLs

  • Get timestamped transcriptions with speaker labels

  • Process various Instagram URL formats (posts, reels, IGTV)

Example

Extract transcript from: https://instagram.com/reel/ABC123/

The server will:

  1. Extract the video URL from the Instagram post

  2. Use AssemblyAI to transcribe the audio

  3. Return a formatted transcript with timestamps and speaker labels

Development

This project uses uv for dependency management. The dependencies are defined in pyproject.toml and the lockfile is uv.lock.

To run the server locally:

uv run main.py

Features

  • ✅ Instagram URL validation and processing

  • ✅ Direct video URL extraction using instaloader

  • ✅ AssemblyAI transcription with speaker labels

  • ✅ Timestamp formatting

  • ✅ Environment variable configuration

  • ✅ Comprehensive error handling

Available Tools

1 tool
get_instagram_transcriptA

Extract transcript from Instagram video/reel using AssemblyAI.

Args:
    url: Instagram post or reel URL (e.g., https://instagram.com/p/ABC123/ or https://instagram.com/reel/XYZ789/)
    assemblyai_api_key: AssemblyAI API key (optional if ASSEMBLYAI_API_KEY environment variable is set)

Returns:
    The transcript text with timestamps and speaker labels

Inputs: url (required), assemblyai_api_key. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusing it with others. The tool's purpose is clearly stated and unambiguous.

    Naming Consistency5/5

    The single tool name 'get_instagram_transcript' follows a clear verb_noun pattern, making it descriptive and predictable. Though there are no other tools to compare, the naming is well-formed and consistent with common conventions.

    Tool Count2/5

    The server name 'Social MCP' implies a broad social media toolkit, yet it contains only one tool for Instagram transcripts. This is far too few for the apparent scope, making the tool count feel inadequate and mismatched.

    Completeness1/5

    For a social media server, having only Instagram transcript extraction leaves enormous gaps. There is no support for other platforms, and even for Instagram, there are no other operations beyond transcripts. The surface is severely incomplete for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers