Content
# MCP Medium Server
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI assistants to publish posts to Medium.
## Features
- **Publish Posts**: Create and publish articles to Medium
- **Draft Support**: Publish as draft, unlisted, or public
- **Tag Management**: Add tags to your posts
- **Canonical URLs**: Set canonical URLs for SEO
- **Follower Notifications**: Optionally notify followers when publishing
## Installation
### Via npx (Recommended)
```bash
npx mcp-medium
```
### Local Development
```bash
git clone <repository-url>
cd mcp-medium
pnpm install
pnpm build
pnpm start
```
## Setup
### 1. Get Medium API Token
1. Go to [Medium Settings](https://medium.com/me/settings)
2. Scroll down to "Integration tokens"
3. Generate a new token
4. Copy the token for use in your environment
### 2. Set Environment Variable
```bash
export MEDIUM_TOKEN="your_medium_token_here"
```
### 3. Configure MCP Client
Add this server to your MCP client configuration:
**Claude Desktop (config.json):**
```json
{
"mcpServers": {
"medium": {
"command": "npx",
"args": ["mcp-medium"],
"env": {
"MEDIUM_TOKEN": "your_medium_token_here"
}
}
}
}
```
**Other MCP Clients:**
```bash
npx mcp-medium
```
## Usage
Once configured, you can ask your AI assistant to publish posts to Medium:
> "Please publish this article to Medium as a draft with the tags 'programming' and 'typescript'"
> "Publish this post to Medium publicly and notify my followers"
### Available Parameters
- **title** (required): The post title
- **content** (required): The post content (HTML format)
- **tags** (optional): Array of tags for the post
- **canonicalUrl** (optional): Canonical URL for SEO
- **publishStatus** (optional): "draft", "unlisted", or "public" (default: "draft")
## Example
```typescript
// The AI assistant can call this tool:
publishPost({
title: "My First MCP Post",
content: "<h1>Hello World</h1><p>This is my first post via MCP!</p>",
tags: ["mcp", "automation"],
publishStatus: "draft"
})
```
## Development
### Build
```bash
pnpm build
```
### Development Mode
```bash
pnpm dev
```
### Lint
```bash
pnpm lint
pnpm fix
```
## Requirements
- Node.js 18+
- Medium account with API access
- Valid Medium integration token
## License
MIT
## Author
**Jay Simons**
- Website: [https://yaa.bz](https://yaa.bz)
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Support
If you encounter any issues or have questions, please file an issue on the repository.
