Substack/Medium

Substack/Medium

Connect Claude to your Substack/Medium writing, enabling semantic search and analysis of your published content.

23
Stars
2
Forks
0
Releases

Overview

Writer Context Tool is an MCP server that enables Claude to access and analyze your Substack and Medium writing. It fetches posts from your blogs via RSS feeds, caches them permanently on disk, and creates embeddings for each post. This enables semantic search to identify the most relevant essays in response to a query and to present Claude with precise, context-rich resources. Each essay is exposed as a separate resource within Claude Desktop, allowing you to reference full texts or snippets directly in prompts. To improve performance, the server preloads all content and embeddings at startup, so responses can be delivered with low latency. Configuration is managed through a config.json file that lists platforms (type, URL, and a human-friendly name), plus parameters such as max_posts, cache_duration_minutes, and similar_posts_count. The MCP integration is designed to work with Claude Desktop by launching the writer-tool server (scripts are provided to run via uv or an alternative shell script). The solution emphasizes permanent caching, local embedding storage, and selective refresh to ensure Claude always has access to your latest work while maintaining fast access to historical content.

Details

Owner
jonathan-politzki
Language
Python
License
Updated
2025-12-07

Features

Retrieves and permanently caches blog posts

Fetches posts from Substack and Medium via RSS and stores them permanently on disk.

Uses embeddings for relevance

Generates per-post embeddings to support semantic search and identify the most relevant essays.

Individual essay resources

Exposes each essay as a separate resource within Claude Desktop for direct reference.

Semantic search across writing

Enables Claude to perform semantic queries and retrieve relevant content from your library.

Startup preloading

Preloads content and embeddings at startup to minimize latency during queries.

Audience

WritersConnect Claude to their Substack/Medium writing for semantic analysis and writing assistance.
BloggersEnable Claude to search, summarize, and reference their published blog posts.
EditorsAssist editors in extracting insights from authors' content for revisions.

Tags

MCPClaudeSubstackMediumsemantic searchembeddingscachingRSS