MCP Server Medium

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

Quick Start

# Run with uvx (no install needed) — uses MEDIUM_API_KEY env var
MEDIUM_API_KEY=your_token_here uvx mcp-server-medium

# Or use a config file instead
mkdir -p ~/.medium
echo 'api_key: your_token_here' > ~/.medium/config.yaml
uvx mcp-server-medium

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

Authentication

The server resolves your API key in this order:

1. MEDIUM_API_KEY environment variable — best for MCP clients
2. ~/.medium/config.yaml — persistent local config

Create ~/.medium/config.yaml:

api_key: your_integration_token_here

Get your token at medium.com/me/settings (look for "Integration Tokens").

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
get_rss_feed	Fetch and parse Medium RSS feeds into JSON

RSS Feed Shorthands

The get_rss_feed tool accepts flexible input:

Shorthand	Resolves to
@username	https://medium.com/feed/@username
publication-name	https://medium.com/feed/publication-name
tag/tag-name	https://medium.com/feed/tag/tag-name
pub-name/tagged/tag	https://medium.com/feed/pub-name/tagged/tag
Full URL	Used as-is

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": ["mcp-server-medium"],
      "env": {
        "MEDIUM_API_KEY": "your_token_here"
      }
    }
  }
}

Or using the config file (no env needed):

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

With ~/.medium/config.yaml:

api_key: your_token_here

License

MIT