TellMySocials MCP Server

This MCP (Model Context Protocol) server allows any AI client (like Claude Desktop, Cline, or other MCP-compatible clients) to post and schedule social media content through TellMySocials.

Features

• create_post - Create and schedule posts to 13+ social media platforms
• list_connected_accounts - View all connected social media accounts
• list_scheduled_posts - View upcoming scheduled posts
• delete_post - Delete a scheduled post

Supported Platforms

• Facebook
• Instagram
• Twitter/X
• LinkedIn
• TikTok
• YouTube
• Pinterest
• Threads
• Bluesky
• Mastodon
• Reddit
• Tumblr
• Substack

Installation

Prerequisites

1. A TellMySocials account with connected social media accounts
2. An API token from TellMySocials (get it from Settings > API)

For Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "leulsege": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-server/src/index.ts"],
      "env": {
        "TELLMYSOCIALS_API_TOKEN": "your-api-token-here",
        "TELLMYSOCIALS_API_URL": "https://04d297d6-d08c-4ba7-a131-762b84ddbad1-00-3r12ccpri0pk2.picard.replit.dev"
      }
    }
  }
}

For other MCP clients

Set these environment variables:

export TELLMYSOCIALS_API_TOKEN="your-api-token-here"
export TELLMYSOCIALS_API_URL="https://04d297d6-d08c-4ba7-a131-762b84ddbad1-00-3r12ccpri0pk2.picard.replit.dev"

Then run:

npx tsx /path/to/mcp-server/src/index.ts

Usage Examples

Once configured, you can ask your AI assistant things like:

• "Post 'Hello world!' to my Twitter and LinkedIn accounts"
• "Schedule a post for tomorrow at 10am saying 'Check out our new product launch!'"
• "Show me my connected social media accounts"
• "List my upcoming scheduled posts"
• "Delete post number 123"

API Token

Get your API token from TellMySocials:

1. Log in to https://tellmysocials.com
2. Go to Settings > API
3. Create a new API token
4. Copy the token and add it to your MCP config

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start