Medium MCP Server (Browser-Based)

Overview

Medium MCP (Model Context Protocol) is a browser-based solution for programmatically interacting with Medium’s content ecosystem. Since Medium discontinued their public API for new users, this server uses browser automation to provide intelligent and context-aware content management.

🔄 Why Browser-Based?

Medium stopped issuing new API tokens in 2023, making traditional API integration impossible for new developers. This implementation uses Playwright browser automation to:

• ✅ Work without API tokens - Uses your existing Medium login session
• ✅ Full functionality - Publish, search, and manage your Medium content
• ✅ Secure - Saves your login session locally for reuse
• ✅ Interactive - Opens browser for initial login, then runs headlessly

📖 Deep Dive Article

Want to understand the full story behind Medium MCP? Check out the comprehensive article:

From Thought to Published: How MediumMCP Streamlines the AI-to-Medium Platform Workflow

Key Features

• 🤖 Browser automation for Medium interaction
• 📝 Article publishing with title, content, and tags
• 📚 Retrieve your articles from your Medium profile
• 🔍 Search Medium articles by keywords
• 💾 Session persistence - login once, use everywhere
• 🎯 Claude integration via Model Context Protocol

Technology Stack

• TypeScript
• Model Context Protocol (MCP)
• Playwright Browser Automation
• Advanced Content Parsing

Getting Started

Prerequisites

• Node.js (v16 or later)
• npm or yarn
• A Medium account (no API credentials needed!)

Installation

# Clone the repository
git clone https://github.com/jackyckma/medium-mcp-server.git

# Navigate to the project directory
cd medium-mcp-server

# Install dependencies
npm install

# Install browser for automation
npx playwright install chromium

# Build the project
npm run build

Configuration

No API keys needed! The server will prompt you to login to Medium in your browser on first use.

Usage

Test the Browser Client

# Test the browser automation (optional)
node test-browser.js

Start the MCP Server

npm start

Add to Claude Configuration

Add this to your Claude MCP configuration:

{
  "mcpServers": {
    "medium-mcp": {
      "command": "node",
      "args": ["path/to/medium-mcp-server/dist/index.js"],
      "cwd": "path/to/medium-mcp-server"
    }
  }
}

Available MCP Tools

1. publish-article

Publish a new article to Medium

{
  title: string,      // Article title
  content: string,    // Article content (markdown supported)
  tags?: string[],    // Optional tags