Official Substack / Medium MCP Server

Name: Official Substack / Medium MCP Server
Author: jean-technologies

@jean-technologies

关于 Official Substack / Medium MCP Server

The tool connects to your Substack/Medium blogs via their RSS feeds, fetches your posts, and permanently caches them locally. It also generates embeddings for each post, enabling semantic search to find the most relevant essays based on your queries.

#substack #mcp #medium

基本信息

分类

记忆与知识

传输方式

stdio

发布者

jean-technologies

提交者

Jonathan Politzki

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "writer-tool": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/writer-context-tool",
        "run",
        "writer_tool.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Official Substack / Medium MCP Server?

Official Substack / Medium MCP Server is an open-source Model Context Protocol (MCP) implementation that connects Claude to your Substack and Medium writing. It allows Claude to access, cache, and semantically search your published blog posts, providing personalized writing assistance.

How to use Official Substack / Medium MCP Server?

Clone the repository, set up a Python 3.10+ environment with uv or pip, and configure your Substack/Medium RSS URLs in a config.json file. Then connect to Claude Desktop by adding the server to the claude_desktop_config.json configuration. Once running, Claude can access individual essay resources and use the search_writing and refresh_content tools.

Key features of Official Substack / Medium MCP Server

Retrieves and permanently caches blog posts from Substack and Medium
Uses embeddings to find the most relevant essays via semantic search
Makes individual essays available as separate resources for Claude
Preloads all content and generates embeddings at startup
Supports configurable caching duration and maximum posts to fetch
Provides two tools: search_writing and refresh_content

Use cases of Official Substack / Medium MCP Server

Ask Claude to find essays discussing a specific topic across your Substack and Medium archives
Reference individual essays by title when requesting writing feedback or idea development
Automatically refresh your cached content to keep Claude up to date with new posts

FAQ from Official Substack / Medium MCP Server

What platforms does Official Substack / Medium MCP Server support?

Substack and Medium are supported via their RSS feeds.

How does caching work in Official Substack / Medium MCP Server?

Content is stored on disk and persists between sessions. The cache duration is configurable (default 10080 minutes / 1 week). Content and embeddings are automatically refreshed at startup and on demand using the refresh_content tool.

What are the prerequisites for using Official Substack / Medium MCP Server?

Python 3.10 or higher, the latest Claude Desktop, and a Substack or Medium account with published public content.

How can I troubleshoot if the tool doesn't appear in Claude Desktop?

Check that your Claude Desktop configuration file has correct absolute paths, verify all packages are installed, and restart Claude Desktop. You can also try the shell script alternative for the uv command.

How does semantic search work in Official Substack / Medium MCP Server?

Each essay is converted into embeddings at startup. When you use the search_writing tool, embeddings are compared to find the most relevant essays, with the number of results configurable via similar_posts_count.