mcp-writer-substack

mcp-writer-substack

9

The Writer Context Tool for Claude is an open-source MCP server designed to connect Claude to content from Substack and Medium. It retrieves, caches, and allows semantic search of your blog posts to assist with personalized writing support.

Writer Context Tool for Claude

Open-Sourced Model Context Protocol (MCP) implementation that connects Claude to your Substack and Medium writing.

Features

  • Retrieves and permanently caches your blog posts from Substack and Medium
  • Uses embeddings to find the most relevant essays based on your queries
  • Makes individual essays available as separate resources for Claude
  • Performs semantic searches across your writing
  • Preloads all content and generates embeddings at startup

How It Works

The tool connects to your Substack/Medium blogs via their RSS feeds, caches posts locally, and enables semantic search to find relevant essays.

Using the Tool with Claude

  • Search across your writing
    • Ask Claude to find relevant content
  • Reference specific essays
    • Access individual essays by clicking on them
  • Refresh content

Available Tools and Resources

  • Individual Essay Resources
  • search_writing: Finds relevant essays
  • refresh_content: Refreshes and recaches content

How Caching Works

  • Disk Caching: Content is stored on disk
  • Embeddings: Essays are converted for semantic search
  • Selective Refresh: Content refreshes based on settings

Troubleshooting

  • Tool doesn't appear in Claude Desktop
  • No content appears
  • Error with uv command
  • Embedding issues