MCP Server Medium
Allows AI agents to publish posts, manage publications, upload images, and parse RSS feeds to JSON using the Medium API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server Medium publish a post titled 'MCP Server Setup Guide'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mediumRelated MCP server: Paragraph MCP
Authentication
The server resolves your API key in this order:
MEDIUM_API_KEYenvironment variable — best for MCP clients~/.medium/config.yaml— persistent local config
Create ~/.medium/config.yaml:
api_key: your_integration_token_hereGet your token at medium.com/me/settings (look for "Integration Tokens").
Tools
Tool | Description |
| Get the authenticated user's Medium profile |
| List all publications the user is related to |
| List contributors for a publication |
| Create a post on the user's Medium profile |
| Create a post under a specific publication |
| Upload an image to Medium from a URL |
| Fetch and parse Medium RSS feeds into JSON |
RSS Feed Shorthands
The get_rss_feed tool accepts flexible input:
Shorthand | Resolves to |
|
|
|
|
|
|
|
|
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-serverConfiguration
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_hereLicense
MIT
Available Tools
7 toolscreate_postB
Create a post on the authenticated user's Medium profile
Inputs: title (required), content (required), author_id (required), content_format (required), +5 more.
create_publication_postB
Create a post under a specific Medium publication
Inputs: title (required), content (required), content_format (required), publication_id (required), +5 more.
get_profileA
Get the authenticated user's Medium profile (id, username, name, url, imageUrl)
Inputs: no named parameters.
get_rss_feedA
Fetch and parse a Medium RSS feed into JSON. Supports profile (@username), publication (publication-name), topic feeds (tag/tag-name), or any full feed URL
Inputs: feed_url (required), limit.
list_contributorsA
List contributors for a given publication
Inputs: publication_id (required).
list_publicationsA
List all publications the authenticated user is related to (edits, writes, or follows)
Inputs: no named parameters.
upload_imageC
Upload an image to Medium from a URL or file path
Inputs: image_url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct action or resource: creating personal vs publication posts, fetching profile vs RSS feed, listing publications vs contributors, and uploading images. No overlap.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_post, get_profile, list_publications), making them predictable and easy to understand.
7 tools is a well-scoped set for a Medium integration, covering posting, profile retrieval, RSS, publications, contributors, and image upload without being excessive.
The tool set covers the primary Medium API operations: creating posts (personal and publication), retrieving profile and RSS, listing publications and contributors, and uploading images. No obvious gaps given typical API limitations.
Maintenance
Related MCP Connectors
MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
Blog MCP server for AI agents. One signup call returns a blog, an API key and a live URL; then your agent publishes markdown posts and gets public URLs back. Your agent does the writing; you get a dashboard for stats.
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP server for Plane integration, enabling AI agents to interact with Plane APIs and services for project management tasks.100MIT

Paragraph MCPofficial
AlicenseNot gradedqualityFmaintenanceMCP server that connects AI agents to your Paragraph publication, enabling post management, subscriber analytics, and search across posts and publications.1MIT- AlicenseAqualityCmaintenanceAn MCP server for WriteFreely that enables AI agents to publish and manage content on WriteFreely instances (including self-hosted instances and Write.as).103MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server for publishing markdown articles to Medium and Substack via unofficial APIs, with tools to list, create, and manage posts and drafts.-