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)
| File | Size | Uploaded | |
|---|---|---|---|
| medium_mcp_server-0.1.0.tar.gz | 5.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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}
|