# Medium MCP

> Medium MCP lets you control your entire publishing workflow from any AI client. Write content, create drafts, and schedule posts across multiple Medium publications without opening the website. You can get your own profile details or manage specific brand pages using natural conversation. It turns the tedious process of logging into a web app and clicking through forms into simple commands for your agent.

## Overview
- **Category:** content-management
- **Price:** Free
- **Tags:** content-publishing, blogging, draft-management, social-media-management

## Description

You shouldn't have to open the browser every time you want to share an article. This MCP connects your Medium account directly to your AI agent, letting you manage all content tasks using plain language conversation. Need to publish a quick thought or plan out a long-form piece? Just tell your agent what needs writing and where it should go. You can draft articles privately for later review, or push finished pieces live immediately. It also lets you list the publications you belong to, so you can ensure content gets posted under the right brand name. When you connect this MCP through Vinkius, all those publishing tasks become conversational actions within your existing workflow.

## Tools

### create_draft
Saves new content as an unpublished draft for later review and editing.

### create_post
Creates a standard article post that is immediately visible to users on Medium.

### create_public_post
Publishes content as a public article using your user profile.

### create_publication_post
Posts an article directly under the name and branding of one of your managed publications.

### get_authenticated_user
Retrieves detailed information for the user who connected their account to this MCP.

### get_my_user_id
Provides your unique, internal Medium User ID number.

### get_my_profile
Retrieves specific details about your public profile on the platform.

### list_contributors
Shows who is authorized to contribute content to a specific publication you manage.

### list_my_publications
Lists all the publications that you are currently a member of.

### list_publications
Provides a list of various publications associated with your account.

## Prompt Examples

**Prompt:** 
```
Show my Medium profile and user ID.
```

**Response:** 
```
Retrieving your profile... You are logged in as '@username' (ID: 12345).
```

**Prompt:** 
```
Create a draft titled 'My AI Journey' with content 'This is my first post...'
```

**Response:** 
```
Draft created successfully! You can view and edit it on Medium. URL: https://medium.com/p/draft-id
```

**Prompt:** 
```
List my publications.
```

**Response:** 
```
Searching... You are a member of 2 publications: 'The Startup' and 'UX Collective'.
```

## Capabilities

### Create Content Pieces
Publish a finished article immediately to Medium or save it as an unscheduled draft.

### Manage Publications
List all the brand publications you belong to, ensuring your content lands under the correct source name.

### Retrieve User Details
Fetch details about yourself and list other authorized contributors for specific publications.

## Use Cases

### Need to batch-publish articles for multiple clients.
A marketing team needs to post announcements under three different client publications. They ask their agent to first use list_my_publications to confirm the available sources, and then run create_publication_post three separate times, ensuring each article lands correctly under its respective brand.

### Writing a piece that needs review before going live.
A technical writer finishes an article but knows their manager needs to check it. They ask the agent to use create_draft with the final text, saving it safely instead of publishing it immediately.

### Updating your team on who can contribute content.
The editor needs to confirm which members have posting rights for a specific brand. They run list_contributors against that publication's ID to get the current roster, preventing accidental unauthorized posts.

### Checking system access and identity.
A new user is onboarded and needs to confirm their permissions. They ask the agent to use get_my_user_id and list_publications to verify both their personal ID and all available publishing outlets.

## Benefits

- Never manually switch accounts again. You can use tools like create_public_post or create_draft to push content directly from your chat window, keeping you in one place.
- Maintain brand consistency across multiple channels. Use the specialized tool create_publication_post to ensure all articles are correctly filed under a specific company publication name.
- Quickly audit your setup. Get full visibility into who can contribute using list_contributors and also check which publications you belong to with list_my_publications.
- Know exactly who you are. The ability to run get_my_user_id means your AI workflow can reference specific IDs for advanced automation logic.
- Flexibility in publishing mode. Whether you want a quick public blast via create_post or need the safety net of saving an article as a draft using create_draft, it's all handled.

## How It Works

The bottom line is that your AI agent handles all the API calls and publishing logistics for Medium, so you never have to manually navigate the website.

1. Subscribe to this MCP, then enter your unique Medium Integration Token.
2. Connect the token to your preferred AI client (Claude, Cursor, etc.).
3. Tell your agent what you want to do—like 'create a public post about X' or 'list my publications.' The agent executes the task.

## Frequently Asked Questions

**How do I list all the publications available using the Medium MCP?**
You use the list_my_publications tool. This command tells your agent every publication you are a member of, giving you a clean list to choose from when posting.

**Can the Medium MCP publish content under a specific brand name?**
Yes, that's one of its best features. By using create_publication_post, your agent ensures the article is correctly branded and posted directly to a designated publication.

**Does the Medium MCP help me with content ideas?**
No, this MCP handles publishing mechanics only. You must provide the finished text; it doesn't generate new articles or brainstorm topics for you.

**If I use create_post versus create_public_post, what is the difference?**
While both publish content, using create_publication_post gives you granular control to place it under a specific brand. Use create_post when you want a general public article associated with your personal profile.

**What do I need before setting up the Medium MCP?**
You'll need an active Medium account and a valid Medium Integration Token, which you must provide during the setup process to authorize the connection.