Skip to main content

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

Metadata

Release files for medium-mcp-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for medium-mcp-server 0.1.0
File Size Uploaded
medium_mcp_server-0.1.0.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for medium-mcp-server 0.1.0
File Interpreter ABI Platform
medium_mcp_server-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.7 kB

Release files / medium_mcp_server-0.1.0.tar.gz

Download URL medium_mcp_server-0.1.0.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5360a94f9f3f26d37408b3e9d1504ea5df218c30d24f328c2a12e31be061b504
BLAKE2b-256 checksum
How to use checksums
8f8682f67db14363f5e8fae3305822700755660e89b586383d88ed03f8abeb28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / medium_mcp_server-0.1.0-py3-none-any.whl

Download URL medium_mcp_server-0.1.0-py3-none-any.whl
Size 6.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
310862b990b3f1fad44c22af0f854d931ef2adc16b58f1bfaa221f40dfc9c80e
BLAKE2b-256 checksum
How to use checksums
094bfa559bf557309e80b8c13de324fcefa649e0f73281e2b7a7b4dcfa6f757c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page