medium-mcp-server 0.1.0

MCP server for Medium API — publish posts, manage publications, upload images

Medium MCP Server

MCP (Model Context Protocol) server for interacting with the Medium API. Allows AI agents to publish posts, manage publications, and upload images to Medium.

Quick Start

# Set your Medium integration token
export MEDIUM_API_KEY="your_token_from_medium.com/me/settings"

# Run with uvx (no install needed)
uvx medium-mcp-server

# Or install and run
uv tool install medium-mcp-server
medium-mcp-server

Authentication

Get your Medium Integration Token at https://medium.com/me/settings (look for "Integration Tokens" section). Set it as the MEDIUM_API_KEY environment variable.

Tools

Tool	Description
get_profile	Get the authenticated user's Medium profile
list_publications	List all publications the user is related to
list_contributors	List contributors for a publication
create_post	Create a post on the user's Medium profile
create_publication_post	Create a post under a specific publication
upload_image	Upload an image to Medium from a URL

Development

# Clone and setup
git clone https://github.com/afikrim/medium-mcp-server
cd medium-mcp-server
uv sync

# Run locally
MEDIUM_API_KEY=your_key uv run medium-mcp-server

# Use with MCP inspector
MEDIUM_API_KEY=your_key npx @modelcontextprotocol/inspector uv run medium-mcp-server

Configuration

Configure in your MCP client (e.g., Claude Desktop, Cursor):

{
  "mcpServers": {
    "medium": {
      "command": "uvx",
      "args": ["medium-mcp-server"],
      "env": {
        "MEDIUM_API_KEY": "your_token_here"
      }
    }
  }
}

License

MIT