Medium Ops

Medium CLI + 23-tool MCP server. Your IDE drafts replies. No API keys.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "medium-ops": {
      "command": "uvx",
      "args": [
        "medium-ops"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

medium-ops

Standalone Medium CLI + 22-tool MCP server for Cursor MCP, Claude MCP, OpenCode MCP, and any stdio MCP host. Your IDE drafts the replies. Zero AI API keys.

Stories, responses, claps, feed, profiles, stats, reply engine, MCP server. One Python install, one binary, MIT licensed. Sibling of substack-ops.

TL;DR — MCP-native (no API key, one command)

bash

uvx medium-ops mcp install cursor          # or claude-desktop, claude-code, opencode, print
# Restart your host. Then in chat:
#   "list unanswered responses on post abc123def456"
#   "draft a warm reply to response r1"
#   "post that draft"

Your host's LLM (Cursor's, Claude's) does the drafting via the propose_reply / confirm_reply tools. No ANTHROPIC_API_KEY / OPENAI_API_KEY needed.

Wrong install?

This project is medium-ops on PyPI — install with uv / uvx, not unrelated npx packages from “Medium MCP” searches. Canonical listing: Glama — 06ketan/medium-ops.

Works with (MCP)

These rows help discovery (search keywords); confirm each host’s current MCP docs before upgrading.

Open source–oriented hosts

Host	Documentation	Typical wire-up
OpenCode	OpenCode MCP servers	`uvx medium-ops mcp install opencode`
Continue	Continue	`uvx medium-ops mcp install print` — paste the snippet into Continue’s MCP settings
Zed	Zed	Configure stdio MCP per Zed’s docs
Cline	Cline	MCP setup per extension / marketplace docs
Goose	Goose	MCP extensions per Goose docs

Large commercial stacks

Host	Documentation	Typical wire-up
Cursor	Cursor MCP	`uvx medium-ops mcp install cursor`
Claude (Desktop / Code)	Claude Desktop, Claude Code	`mcp install claude-desktop` / `claude-code`
GitHub Copilot	Copilot	MCP in VS Code where supported — use `print` + host docs
ChatGPT	OpenAI	Connector flows — often REST for tools without MCP
Google Gemini	Gemini	Gemini CLI / IDE features per Google docs

OpenCode (copy-paste)

Auto-install:

bash

uvx medium-ops mcp install opencode

Manual (~/.config/opencode/opencode.json):

config.json

{
  "mcp": {
    "medium-ops": {
      "type": "local",
      "command": ["uvx", "medium-ops", "mcp", "serve"],
      "enabled": true
    }
  }
}

Optional version pin: ["uvx", "medium-ops==0.1.2", "mcp", "serve"] (replace with current PyPI release).

Why a hybrid

Medium exposes three usable surfaces and we use all of them:

Public RSS (reads, no auth). medium.com/feed/@{user} returns the author's ~10 most recent stories with body_html, pubDate, tags, hero image, and dc:creator. Zero credentials, faster than GraphQL, stable. Used by default for list_posts / get_post / get_post_content. Inspired by Portfolio_V2's blog page.
Dashboard GraphQL (authenticated reads). medium.com/_/graphql + medium.com/_/api/* with the sid cookie. Used as a fallback when you ask for more than ~10 posts, when the post isn't in the RSS window, or for things RSS can't give you (responses, claps, feed, stats, search).
Official REST (writes). api.medium.com/v1/* with an Integration Token. Supports createPost, createPostInPublication, getUser, getPublications. That's it.

Force a specific transport with --source rss|graphql|auto on posts list, posts show, and posts content. The dashboard + GraphQL endpoints are undocumented and Medium can change them at any time. See Known gaps.

Setup (dev / from source)

bash

git clone https://github.com/06ketan/medium-ops && cd medium-ops
uv sync
uv sync --extra mcp     # mcp SDK for the MCP server (recommended)
uv sync --extra tui     # textual for the TUI

Auth is read from ~/.cursor/mcp.json's mcpServers.medium-ops.env (or medium-api / medium). Override with env or .env.

bash

uv run medium-ops auth verify
uv run medium-ops quickstart

Command surface

Every write defaults to --dry-run. Flip with --no-dry-run. All writes land in .cache/audit.jsonl and are dedup-checked against .cache/actions.db.

Auth (3)

Command	What it does
`auth verify`	Probe both integration token (/me) and sid cookie (GraphQL Viewer).
`auth test`	Same but exits non-zero on failure (CI-friendly).
`auth setup`	Interactive: paste token / sid / uid / username to `.env`.

Read — Stories (5)

Command	What it does
`posts list [--user] [--limit]`	Latest stories by a user (default: self).
`posts show <id_or_url>`	Story metadata (title, clap count, response count).
`posts content <id> [--md]`	Body HTML (or Markdown with `--md`).
`posts search <query> [--limit]`	Medium-side full-text search.
`posts publish -t "..." -f body.md [--pub] [--status draft	public

Read + Write — Responses (3)

Command	What it does
`responses list <post_id> [--limit]`	Top-level responses table.
`responses tree <post_id> [--out file.json]`	Full response + reply tree JSON.
`responses add <post_id> "body" [--parent <r_id>] [--no-dry-run]`	Post a response or reply.

Read + Write — Claps (2)

Command	What it does
`claps count <post_id>`	Total claps.
`claps give <post_id> [--claps N] [--no-dry-run]`	Clap 1-50 times. Dedup-protected.

Read — Discovery + Profile (5)

Command	What it does
`feed list [--tab home\|following\|tag-{slug}] [--limit]`	Reader feed.
`profile me`	Your full profile (GraphQL).
`profile get <username>`	Any user's public profile.
`profile stats [--days N]`	Per-post views / reads / fans (dashboard scrape).
`profile publications`	Publications you can publish to (integration token).

Reply engine (3)

Command	What it does
`reply template <post_id> --template thanks`	Rule-based replies (no LLM).
`reply bulk <post_id> --out drafts.json`	Draft every response to a file.
`reply bulk-send drafts.json [--no-dry-run]`	Post only `action=approved` rows. Dedup-checked.

Operations + safety (2)

Command	What it does
`audit search [--kind] [--target] [--status] [--since 7d]`	Query the JSONL audit log.
`audit dedup-status`	Counts in the dedup SQLite DB.

MCP server (3)

Command	What it does
`mcp install <cursor\|claude-desktop\|claude-code\|opencode\|print> [--dry-run]`	Auto-merge config into your host.
`mcp serve`	stdio MCP server (22 tools).
`mcp list-tools`	Print the tool registry.

Other (1)

Command	What it does
`quickstart`	Print a quickstart checklist.

Reply modes

Mode	What it does	Safety
`template`	YAML keyword rules under `src/medium_ops/templates/*.yaml`	dry-run default
`bulk`	LLM drafts every response to `drafts.json`. Edit, set `action: "approved"`	offline review, dedup-checked on send
`bulk-send`	Posts only items with `action: "approved"`	dry-run default; dedup DB prevents dup replies
MCP `propose_reply` → `confirm_reply`	Host LLM drafts, you approve per-item, token-gated	5-min token TTL, idempotent, no API key

MCP server

bash

medium-ops mcp install opencode          # ~/.config/opencode/opencode.json
medium-ops mcp install cursor              # auto-add to ~/.cursor/mcp.json
medium-ops mcp install claude-desktop      # auto-add to claude_desktop_config.json
medium-ops mcp install claude-code         # uses `claude mcp add`
medium-ops mcp install print               # print the snippet only
medium-ops mcp serve                       # stdio server
medium-ops mcp list-tools                  # 22 tools

Manual config snippet:

config.json

{
  "mcpServers": {
    "medium-ops": {
      "command": "medium-ops",
      "args": ["mcp", "serve"]
    }
  }
}

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Medium Ops

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "medium-ops": { "command": "uvx", "args": ["medium-ops"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/medium-ops?style=directory)](https://allmcps.com/mcp/medium-ops)

HTML Embed

<a href="https://allmcps.com/mcp/medium-ops"><img src="https://allmcps.com/api/badge/medium-ops?style=directory" alt="Medium Ops on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

8/10 checks healthy over the last 45d

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · medium-ops (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Medium Ops →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Medium Ops

Medium CLI + 23-tool MCP server. Your IDE drafts replies. No API keys.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "medium-ops": {
      "command": "uvx",
      "args": [
        "medium-ops"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

medium-ops

Standalone Medium CLI + 22-tool MCP server for Cursor MCP, Claude MCP, OpenCode MCP, and any stdio MCP host. Your IDE drafts the replies. Zero AI API keys.

Stories, responses, claps, feed, profiles, stats, reply engine, MCP server. One Python install, one binary, MIT licensed. Sibling of substack-ops.

TL;DR — MCP-native (no API key, one command)

bash

uvx medium-ops mcp install cursor          # or claude-desktop, claude-code, opencode, print
# Restart your host. Then in chat:
#   "list unanswered responses on post abc123def456"
#   "draft a warm reply to response r1"
#   "post that draft"

Your host's LLM (Cursor's, Claude's) does the drafting via the propose_reply / confirm_reply tools. No ANTHROPIC_API_KEY / OPENAI_API_KEY needed.

Wrong install?

This project is medium-ops on PyPI — install with uv / uvx, not unrelated npx packages from “Medium MCP” searches. Canonical listing: Glama — 06ketan/medium-ops.

Works with (MCP)

These rows help discovery (search keywords); confirm each host’s current MCP docs before upgrading.

Open source–oriented hosts

Host	Documentation	Typical wire-up
OpenCode	OpenCode MCP servers	`uvx medium-ops mcp install opencode`
Continue	Continue	`uvx medium-ops mcp install print` — paste the snippet into Continue’s MCP settings
Zed	Zed	Configure stdio MCP per Zed’s docs
Cline	Cline	MCP setup per extension / marketplace docs
Goose	Goose	MCP extensions per Goose docs

Large commercial stacks

Host	Documentation	Typical wire-up
Cursor	Cursor MCP	`uvx medium-ops mcp install cursor`
Claude (Desktop / Code)	Claude Desktop, Claude Code	`mcp install claude-desktop` / `claude-code`
GitHub Copilot	Copilot	MCP in VS Code where supported — use `print` + host docs
ChatGPT	OpenAI	Connector flows — often REST for tools without MCP
Google Gemini	Gemini	Gemini CLI / IDE features per Google docs

OpenCode (copy-paste)

Auto-install:

bash

uvx medium-ops mcp install opencode

Manual (~/.config/opencode/opencode.json):

config.json

{
  "mcp": {
    "medium-ops": {
      "type": "local",
      "command": ["uvx", "medium-ops", "mcp", "serve"],
      "enabled": true
    }
  }
}

Optional version pin: ["uvx", "medium-ops==0.1.2", "mcp", "serve"] (replace with current PyPI release).

Why a hybrid

Medium exposes three usable surfaces and we use all of them:

Public RSS (reads, no auth). medium.com/feed/@{user} returns the author's ~10 most recent stories with body_html, pubDate, tags, hero image, and dc:creator. Zero credentials, faster than GraphQL, stable. Used by default for list_posts / get_post / get_post_content. Inspired by Portfolio_V2's blog page.
Dashboard GraphQL (authenticated reads). medium.com/_/graphql + medium.com/_/api/* with the sid cookie. Used as a fallback when you ask for more than ~10 posts, when the post isn't in the RSS window, or for things RSS can't give you (responses, claps, feed, stats, search).
Official REST (writes). api.medium.com/v1/* with an Integration Token. Supports createPost, createPostInPublication, getUser, getPublications. That's it.

Setup (dev / from source)

bash

git clone https://github.com/06ketan/medium-ops && cd medium-ops
uv sync
uv sync --extra mcp     # mcp SDK for the MCP server (recommended)
uv sync --extra tui     # textual for the TUI

Auth is read from ~/.cursor/mcp.json's mcpServers.medium-ops.env (or medium-api / medium). Override with env or .env.

bash

uv run medium-ops auth verify
uv run medium-ops quickstart

Command surface

Every write defaults to --dry-run. Flip with --no-dry-run. All writes land in .cache/audit.jsonl and are dedup-checked against .cache/actions.db.

Auth (3)

Command	What it does
`auth verify`	Probe both integration token (/me) and sid cookie (GraphQL Viewer).
`auth test`	Same but exits non-zero on failure (CI-friendly).
`auth setup`	Interactive: paste token / sid / uid / username to `.env`.

Read — Stories (5)

Command	What it does
`posts list [--user] [--limit]`	Latest stories by a user (default: self).
`posts show <id_or_url>`	Story metadata (title, clap count, response count).
`posts content <id> [--md]`	Body HTML (or Markdown with `--md`).
`posts search <query> [--limit]`	Medium-side full-text search.
`posts publish -t "..." -f body.md [--pub] [--status draft	public

Read + Write — Responses (3)

Command	What it does
`responses list <post_id> [--limit]`	Top-level responses table.
`responses tree <post_id> [--out file.json]`	Full response + reply tree JSON.
`responses add <post_id> "body" [--parent <r_id>] [--no-dry-run]`	Post a response or reply.

Read + Write — Claps (2)

Command	What it does
`claps count <post_id>`	Total claps.
`claps give <post_id> [--claps N] [--no-dry-run]`	Clap 1-50 times. Dedup-protected.

Read — Discovery + Profile (5)

Command	What it does
`feed list [--tab home\|following\|tag-{slug}] [--limit]`	Reader feed.
`profile me`	Your full profile (GraphQL).
`profile get <username>`	Any user's public profile.
`profile stats [--days N]`	Per-post views / reads / fans (dashboard scrape).
`profile publications`	Publications you can publish to (integration token).

Reply engine (3)

Command	What it does
`reply template <post_id> --template thanks`	Rule-based replies (no LLM).
`reply bulk <post_id> --out drafts.json`	Draft every response to a file.
`reply bulk-send drafts.json [--no-dry-run]`	Post only `action=approved` rows. Dedup-checked.

Operations + safety (2)

Command	What it does
`audit search [--kind] [--target] [--status] [--since 7d]`	Query the JSONL audit log.
`audit dedup-status`	Counts in the dedup SQLite DB.

MCP server (3)

Command	What it does
`mcp install <cursor\|claude-desktop\|claude-code\|opencode\|print> [--dry-run]`	Auto-merge config into your host.
`mcp serve`	stdio MCP server (22 tools).
`mcp list-tools`	Print the tool registry.

Other (1)

Command	What it does
`quickstart`	Print a quickstart checklist.

Reply modes

Mode	What it does	Safety
`template`	YAML keyword rules under `src/medium_ops/templates/*.yaml`	dry-run default
`bulk`	LLM drafts every response to `drafts.json`. Edit, set `action: "approved"`	offline review, dedup-checked on send
`bulk-send`	Posts only items with `action: "approved"`	dry-run default; dedup DB prevents dup replies
MCP `propose_reply` → `confirm_reply`	Host LLM drafts, you approve per-item, token-gated	5-min token TTL, idempotent, no API key

MCP server

bash

medium-ops mcp install opencode          # ~/.config/opencode/opencode.json
medium-ops mcp install cursor              # auto-add to ~/.cursor/mcp.json
medium-ops mcp install claude-desktop      # auto-add to claude_desktop_config.json
medium-ops mcp install claude-code         # uses `claude mcp add`
medium-ops mcp install print               # print the snippet only
medium-ops mcp serve                       # stdio server
medium-ops mcp list-tools                  # 22 tools

Manual config snippet:

config.json

{
  "mcpServers": {
    "medium-ops": {
      "command": "medium-ops",
      "args": ["mcp", "serve"]
    }
  }
}

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Medium Ops

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "medium-ops": { "command": "uvx", "args": ["medium-ops"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/medium-ops?style=directory)](https://allmcps.com/mcp/medium-ops)

HTML Embed

<a href="https://allmcps.com/mcp/medium-ops"><img src="https://allmcps.com/api/badge/medium-ops?style=directory" alt="Medium Ops on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

8/10 checks healthy over the last 45d

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · medium-ops (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Medium Ops →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients