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.
Browser-based MCP server for Medium content management - no API tokens required! Built with AI in hours.
스타
12
도구
—
가동 시간
—
🔄 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:
{
title: string, // Article title
content: string, // Article content (markdown supported)
tags?: string[], // Optional tags
isDraft?: boolean // Save as draft (default: false)
}
2. get-my-articles
Retrieve your published Medium articles
// No parameters needed
// Returns: Array of your articles with titles, URLs, and dates
3. get-article-content
Get full content of any Medium article
{
url: string // Medium article URL
}
4. search-medium
Search Medium for articles by keywords
{
keywords: string[] // Array of search terms
}
5. login-to-medium
Manually trigger login process
// No parameters needed
// Opens browser for login if not already authenticated
How It Works
First Time Setup
Run the server - It will open a Chrome browser window
Login to Medium - Complete login in the opened browser
Session saved - Your login session is saved locally
Future runs - No login required, runs headlessly
Browser Automation Flow
User Request → MCP Server → Playwright Browser → Medium Website → Response
Session Management
Login session stored in medium-session.json
Automatically reused on subsequent runs
Re-login only if session expires
Example Usage with Claude
User: "Publish an article titled 'AI in 2025' with content about recent developments"
Claude: Uses publish-article tool →
- Opens Medium editor
- Fills in title and content
- Publishes article
- Returns success with article URL
Troubleshooting
Browser Issues
Browser won't open: Check if Chromium is installed (npx playwright install chromium)
Login fails: Clear medium-session.json and try again
Slow performance: Browser automation takes 10-30 seconds per operation
Medium Changes
Selectors outdated: Medium occasionally changes their website structure
Login blocked: Use your regular browser to login first, then try again
Common Errors
Browser not initialized: Restart the server
Login timeout: Increase timeout in browser-client.ts
Element not found: Medium may have changed their UI
Development
Project Structure
src/
├── index.ts # Main MCP server
├── browser-client.ts # Playwright automation
├── auth.ts # Legacy auth (unused)
└── client.ts # Legacy API client (unused)
Testing
# Test browser automation
node test-browser.js
# Run MCP server
npm start
# Build project
npm run build
Security Notes
✅ Local only - No data sent to external servers
✅ Session encryption - Browser handles all security
✅ No API keys - Uses your existing Medium login
⚠️ Browser storage - Session saved locally in JSON file
Limitations
Speed: Browser automation is slower than API calls (10-30s vs 1-2s)
Reliability: Dependent on Medium's website structure
Headless: Requires display for initial login (can run headless after)
Rate limits: Subject to Medium's normal usage limits
Contributing
Contributions welcome! Please read CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE file for details.
Support
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions
📧 Email: [Contact Author]
🤖 CREDIT and DISCLAIMER
AI-Powered Development
This entire Medium MCP Server was developed by AI (Claude/Cursor AI) in just a few hours, demonstrating the remarkable power of AI-assisted development. The complete rewrite from deprecated API to browser automation, including all TypeScript code, documentation, error handling, and testing strategies, was generated through AI collaboration.
What This Demonstrates
✅ AI-First Development: Complex browser automation and MCP integration built rapidly
✅ Real-world Problem Solving: Adapted to Medium's API deprecation with working solution
Given the accelerated AI development process, I welcome any feedback, bug reports, or improvements. This serves as both a working tool and a demonstration of AI development capabilities and limitations.
Use at your own discretion - this is provided "as-is" with the understanding that rapid AI development, while powerful, may not cover all production scenarios.
Note: This is an unofficial tool and is not affiliated with Medium. Use responsibly and in accordance with Medium's Terms of Service.
M
Medium
jackyckma·스타 12개·
Browser-based MCP server for Medium content management - no API tokens required! Built with AI in hours.