Metadata-Version: 2.3
Name: medium-mcp-server
Version: 0.1.0
Summary: MCP server for Medium API — publish posts, manage publications, upload images
Author: afikrim
Author-email: afikrim <afikrim10@gmail.com>
Requires-Dist: feedparser>=6.0.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.28.1
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/afikrim/medium-mcp-server
Project-URL: Repository, https://github.com/afikrim/medium-mcp-server
Description-Content-Type: text/markdown

# 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

```bash
# 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](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

```bash
# 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):

```json
{
  "mcpServers": {
    "medium": {
      "command": "uvx",
      "args": ["medium-mcp-server"],
      "env": {
        "MEDIUM_API_KEY": "your_token_here"
      }
    }
  }
}
```

## License

MIT
