home / mcp / mcp medium server

MCP Medium Server

MCP server for publishing posts to Medium

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "designly1-mcp-medium": {
      "command": "npx",
      "args": [
        "mcp-medium"
      ],
      "env": {
        "MEDIUM_TOKEN": "YOUR_MEDIUM_TOKEN_HERE"
      }
    }
  }
}

You can publish posts to Medium directly from your AI assistant using this MCP server. It supports creating articles, publishing as draft/unlisted/public, adding tags, setting canonical URLs for SEO, and optionally notifying followers when you publish.

How to use

You connect this MCP server to your editor or AI assistant client, then instruct it to publish posts to Medium. When you call the publish action, you provide a title and HTML content, and you can optionally include tags, a canonical URL, and a publish status such as draft, unlisted, or public. You can also choose to notify followers upon publishing. Use practical prompts like “Publish this article to Medium as a draft with the tags ‘programming’ and ‘typescript’” or “Publish this post to Medium publicly and notify my followers.” Ensure you specify the required title and content, and any optional fields you want to include.

How to install

Prerequisites you need before installation are Node.js 18 or newer and a Medium account with API access. Follow the steps below to set up and run the MCP server locally or use it via a quick one-liner.

# Prerequisites
node -v
# Ensure Node.js 18+ is installed

# Quick start with the MCP server via npx (recommended)
npx mcp-medium

# Local development flow
# 1) clone the project (replace <repository-url> with the actual URL)
git clone <repository-url>
# 2) install dependencies
cd mcp-medium
pnpm install
# 3) build the project
pnpm build
# 4) start the server
pnpm start

Setup

1. Get Medium API Token 2. Set Environment Variable 3. Configure MCP Client

# 1. Get Medium API Token
# Go to Medium Settings, find Integration tokens, and generate a new token. Copy it for use in your environment.

# 2. Set Environment Variable
export MEDIUM_TOKEN="your_medium_token_here"

# 3. Configure MCP Client
# Claude Desktop (config.json):
{
  "mcpServers": {
    "medium": {
      "command": "npx",
      "args": ["mcp-medium"],
      "env": {
        "MEDIUM_TOKEN": "your_medium_token_here"
      }
    }
  }
}

# Other MCP Clients:
npx mcp-medium

Notes and examples

- The server exposes a simple publishPost action you can call from your AI assistant. You provide a title, content, and optional fields such as tags, canonicalUrl, and publishStatus.

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"
})

Available tools

publishPost

Publish a post to Medium by providing a title, HTML content, optional tags, an optional canonical URL for SEO, and a publish status which can be draft, unlisted, or public. You can also enable follower notifications when publishing.