Social Media Scheduler MCP Server

An MCP (Model Context Protocol) server that enables AI agents to schedule and manage social media content across multiple platforms.

Features

• Multi-Platform Support: Twitter/X, LinkedIn, Bluesky, and Mastodon
• Post Scheduling: Schedule posts for future publishing with natural language time parsing
• Thread Support: Create multi-post threads on supported platforms
• Content Validation: Check character limits and platform-specific rules before posting
• Analytics: Get engagement metrics for published posts
• Optimal Timing: Get recommended posting times based on engagement patterns

Installation

npm install @autonomous-claude/social-media-scheduler-mcp

Or clone and build:

git clone https://github.com/autonomous-claude/social-media-scheduler-mcp
cd social-media-scheduler-mcp
npm install
npm run build

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "social-scheduler": {
      "command": "node",
      "args": ["/path/to/social-media-scheduler-mcp/dist/index.js"]
    }
  }
}

With MCP Client

import { Client } from '@modelcontextprotocol/sdk/client/index.js';

// Connect to the server
const client = new Client({...});

// Schedule a post
await client.callTool({
  name: 'schedule_post',
  arguments: {
    platform: 'twitter',
    text: 'Hello from MCP! #automation',
    scheduledAt: 'tomorrow at 9am',
    timezone: 'America/New_York'
  }
});

Available Tools

create_post

Create and optionally publish a social media post immediately.

{
  "platform": "twitter",
  "text": "Hello world!",
  "postNow": true
}

schedule_post

Schedule a post for future publishing.

{
  "platform": "linkedin",
  "text": "Excited to share our latest update...",
  "scheduledAt": "2024-01-15T09:00:00Z",
  "timezone": "UTC"
}

Supports natural language scheduling:

• "tomorrow at 9am"
• "next week"
• ISO 8601 format

create_thread

Create a multi-post thread (Twitter, Bluesky, Mastodon).

{
  "platform": "twitter",
  "posts": [
    "Thread time! Here's what I learned about MCP (1/3)",
    "First, MCP provides a standard protocol for AI-tool communication (2/3)",
    "Finally, it enables amazing automation workflows! (3/3)"
  ]
}

list_scheduled

List scheduled posts with filters.

{
  "platform": "twitter",
  "status": "pending",
  "limit": 20
}

cancel_post

Cancel a scheduled post.

{
  "postId": "post_123456789_abc"
}

reschedule_post

Change the scheduled time for a pending post.

{
  "postId": "post_123456789_abc",
  "newScheduledAt": "2024-01-20T14:00:00Z"
}

get_analytics

Get engagement analytics for published posts.

{
  "postId": "post_123456789_abc"
}

get_optimal_times

Get recommended posting times.

{
  "platform": "linkedin",
  "timezone": "America/Los_Angeles"
}

validate_content

Check if content meets platform requirements.

{
  "platform": "twitter",
  "text": "This is my tweet with #hashtags and @mentions"
}

set_credentials

Configure API credentials for a platform.

{
  "platform": "twitter",
  "credentials": {
    "apiKey": "your-api-key",
    "apiSecret": "your-api-secret",
    "accessToken": "your-access-token",
    "accessSecret": "your-access-secret"
  }
}

get_platform_limits

Get character and media limits for a platform.

{
  "platform": "twitter"
}

Platform Limits

| Platform | Max Text | Max Media | Threads | |----------|----------|-----------|---------| | Twitter | 280 | 4 | Yes | | LinkedIn | 3000 | 20 | No | | Bluesky | 300 | 4 | Yes | | Mastodon | 500* | 4 | Yes |

*Mastodon limit varies by instance

Resources

The server exposes two resources:

• scheduler://queue - View all pending scheduled posts
• scheduler://published - View recently published posts with analytics

Platform Credentials

Twitter/X

Requires OAuth 1.0a credentials:

• API Key (Consumer Key)
• API Secret (Consumer Secret)
• Access Token
• Access Token Secret

Get these from Twitter Developer Portal.

LinkedIn

Requires OAuth 2.0 access token with w_member_social scope. Get from LinkedIn Developer Portal.

Bluesky

Requires:

• Handle (e.g., user.bsky.social)
• App Password (create in Bluesky settings)

Mastodon

Requires:

• Instance URL (e.g., https://mastodon.social)
• Access Token (create in Mastodon settings > Development)

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

Apify Deployment

This server can be deployed to Apify for pay-per-event monetization:

# Install Apify CLI
npm install -g apify-cli

# Login to Apify
apify login

# Deploy
npm run apify:push

See DEPLOY.md for detailed deployment instructions.

License

MIT

Contributing

Contributions welcome! Please read our contributing guidelines before submitting PRs.