Bluesky Social MCP

Bluesky Social MCP

Interact with the Bluesky social network through an MCP server.

14
Stars
7
Forks
14
Watchers
4
Issues
Bluesky Social MCP provides an MCP-compliant server to interface with the Bluesky social platform using the atproto client. It enables a wide range of profile, feed, post management, and interaction features, all accessible via a standardized Model Context Protocol server setup. The project supports easy configuration, local deployment, and multiple authentication and posting operations.

Key Features

Full MCP server implementation for Bluesky
Authentication and session management
Profile retrieval and management
Managing follows, followers, mutes, and blocks
Feed retrieval including timelines and author feeds
Post creation, editing, deletion, and media attachments
Post interactions: like, unlike, repost, unrepost
Support for both public and local (dev) deployments
Comprehensive test coverage using live Bluesky connections
Configurable via MCP server configuration files

Use Cases

Automating social media posting on Bluesky
Building AI-driven bots for Bluesky using MCP
Monitoring and analyzing activity feeds programmatically
Bulk managing follows, mutes, and user relationships
Creating tools to interact with and aggregate Bluesky post data
Developing social analytics dashboards
Synchronized content publishing across MCP-compatible services
Automated moderation or content curation workflows
Researching social network activity trends
Integrating Bluesky with multi-platform social tooling

README

Bluesky Social MCP

An MCP server for interacting with the Bluesky social network via the atproto client.

:wave: Leave an issue if you have any problems running this MCP. I should be able to push out fixes pretty quickly.

Quick Start

Get your Bluesky app password at: https://bsky.app/settings/app-passwords

Add the following to your MCP config file (Note that the version is pinned):

json
{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}
  • For security reasons, I think its best to keep it pinned and manually change your config to update the version.

Tool Status

All tools have been implemented and tested ✅

Authentication & Setup

  • check_auth_status - Check if the current session is authenticated

Profile Operations

  • get_profile - Get a user profile (Client method: get_profile)
  • get_follows - Get users followed by an account (Client method: get_follows)
  • get_followers - Get users who follow an account (Client method: get_followers)
  • follow_user - Follow a user (Client method: follow)
  • unfollow_user - Unfollow a user (Client method: unfollow)
  • mute_user - Mute a user (Client method: mute)
  • unmute_user - Unmute a user (Client method: unmute)
  • resolve_handle - Resolve a handle to DID (Client method: resolve_handle)

Feed Operations

  • get_timeline - Get posts from your home timeline (Client method: get_timeline)
  • get_author_feed - Get posts from a specific user (Client method: get_author_feed)
  • get_post_thread - Get a full conversation thread (Client method: get_post_thread)

Post Interactions

  • like_post - Like a post (Client method: like)
  • unlike_post - Unlike a post (Client method: unlike)
  • get_likes - Get likes for a post (Client method: get_likes)
  • repost - Repost a post (Client method: repost)
  • unrepost - Remove a repost (Client method: unrepost)
  • get_reposted_by - Get users who reposted (Client method: get_reposted_by)

Post Creation & Management

  • send_post - Create a new text post (Client method: send_post)
  • send_image - Send a post with a single image (Client method: send_image)
  • send_images - Send a post with multiple images (Client method: send_images)
  • send_video - Send a post with a video (Client method: send_video)
  • delete_post - Delete a post (Client method: delete_post)
  • get_post - Get a specific post (Client method: get_post)
  • get_posts - Get multiple posts (Client method: get_posts)

Run from local clone of repo.

bash
{
    "mcpServers": {
        "bluesky-social": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/bluesky-social-mcp",
                "run",
                "server.py"
            ]
            "env": {
                "BLUESKY_IDENTIFIER": "user-name.bsky.social‬",
                "BLUESKY_APP_PASSWORD": "app-password-here"
            }
        }
    }
}

Dev Setup

  1. Install dependencies:

    bash
    uv sync
    
  2. Run the server:

    bash
    uv run bluesky-social-mcp
    

Debug with MCP Inspector

bash
mcp dev server.py
mcp dev server.py --with-editable .

Run the tests

  • I run the tests against the actual Bluesky server.
  • The tests will use BLUESKY_IDENTIFIER, and BLUESKY_APP_PASSWORD env vars.
bash
uv run pytest

Star History

Star History Chart

Repository Owner

gwbischof
gwbischof

User

Repository Details

Language Python
Default Branch main
Size 525 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
99.42%
Dockerfile
0.58%

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Twitter MCP Server

    Twitter MCP Server

    Programmatic Twitter account management via an MCP-compliant server.

    Twitter MCP Server enables programmatic management of Twitter accounts with features such as retrieving home timelines, fetching user tweets, conducting hashtag searches, handling direct messages, and performing tweet creation or deletion. The server appears designed for integration into multi-channel platforms following the Model Context Protocol. It requires Python 3.11+, utilizes environment configuration for credentials, and offers an API-driven interface for various Twitter operations.

    • 47
    • MCP
    • LuniaKunal/mcp-twitter
  • Facebook MCP Server

    Facebook MCP Server

    AI-ready tools for managing and moderating Facebook Pages via the Graph API.

    Facebook MCP Server is a Model Context Protocol (MCP) server designed to automate and manage interactions on Facebook Pages through the Facebook Graph API. It offers a suite of tools accessible by AI agents or LLMs, enabling actions such as posting, moderating comments, retrieving analytics, and handling negative feedback. The platform is optimized for integration with agent clients like Claude Desktop, providing seamless, natural language-driven operations. By abstracting Facebook operations as callable functions, it empowers users to efficiently control and monitor their social media presence.

    • 64
    • MCP
    • HagaiHen/facebook-mcp-server
  • Macrocosmos MCP

    Macrocosmos MCP

    Official Model Context Protocol server for real-time social and video data integration.

    Macrocosmos MCP is the official server implementation of the Model Context Protocol (MCP). It connects AI clients with real-time data from platforms like X, Reddit, and YouTube, powered by Data Universe (SN13) on Bittensor. The server enables MCP-compatible clients to fetch social media and video transcript data for enhanced contextual understanding. It supports integration with tools such as Claude Desktop, Cursor, Windsurf, and OpenAI Agents.

    • 24
    • MCP
    • macrocosm-os/macrocosmos-mcp
  • Utopia MCP Server

    Utopia MCP Server

    A simulation MCP Server for orchestrating smart home and lifestyle devices via AI Agents.

    Utopia MCP Server simulates a wide range of smart home and lifestyle devices, enabling AI agents to interact with and control them through the Model Context Protocol. It provides endpoints for managing devices like lighting, climate control, audio, security, and household robots, allowing for complex, user-centered tasks to be automated without explicit workflow programming. The server is designed to facilitate the testing and experimentation of AI-driven orchestration among multiple simulated endpoints in household environments.

    • 9
    • MCP
    • altinoren/Utopia
  • Azure DevOps MCP Server

    Azure DevOps MCP Server

    Standardized AI access to Azure DevOps via Model Context Protocol.

    Implements the Model Context Protocol (MCP) to enable AI assistants to securely and efficiently interact with Azure DevOps resources. Provides a standardized bridge for managing projects, work items, repositories, pull requests, and pipelines through natural language interfaces. Supports modular authentication and a feature-based architecture for scalability and integration. Facilitates seamless integration with AI tools such as Claude Desktop and Cursor AI.

    • 306
    • MCP
    • Tiberriver256/mcp-server-azure-devops
  • Teamwork MCP Server

    Teamwork MCP Server

    Seamless Teamwork.com integration for Large Language Models via the Model Context Protocol

    Teamwork MCP Server is an implementation of the Model Context Protocol (MCP) that enables Large Language Models to interact securely and programmatically with Teamwork.com. It offers standardized interfaces, including HTTP and STDIO, allowing AI agents to perform various project management operations. The server supports multiple authentication methods, an extensible toolset architecture, and is designed for production deployments. It provides read-only capability for safe integrations and robust observability features.

    • 11
    • MCP
    • Teamwork/mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results