substack-mcp
FastMCP server for Substack: publish Notes and posts, pull analytics, manage drafts, bridge Obsidian vault drafts to Substack, and generate visual cards with pluggable image generators.
Quick reference
substack__test_connection -- verify auth (start here)
substack__publish_note text=... -- publish a Note immediately
substack__list_vault_drafts -- show drafts from your vault file
substack__publish_vault_draft index=N -- publish one vault draft as a Note
substack__create_draft title=... body=... -- create a post draft
substack__get_dashboard days=30 -- subscriber + view KPIs
substack__capture_analytics_to_vault -- snapshot analytics to vault markdown
Tool inventory (30)
Notes + vault pipeline
test_connection(publication?) -- verify auth, return your profilelist_publications() -- show configured publications and which is defaultpublish_note(text, publication?, attachment_ids?) -- publish a Note immediately; markdown supportedcreate_note_attachment(image_path?, image_url?, link_url?, publication?) -- upload image or register link; returns attachment UUID for use with publish_notelist_my_notes(limit?, publication?) -- your recent Notes with reaction + comment countsreply_to_note(note_id, text, publication?) -- reply to a Note by IDlist_vault_drafts() -- parse vault drafts file, return index + preview for each draftpublish_vault_draft(index, publication?, move_to_published?) -- publish one vault draft as a Notebatch_publish_vault_drafts(indices, publication?) -- publish multiple vault drafts in sequence
Post management
create_draft(title, body, subtitle?, audience?, publication?, section_id?) -- create a post draft; body is markdownupdate_draft(draft_id, title?, body?, subtitle?, audience?, publication?, section_id?) -- edit an existing draftpublish_post(draft_id, send_email?, audience?, publication?, section_id?) -- publish a draft live to subscribersschedule_post(draft_id, publish_at, publication?, section_id?) -- schedule a draft for future publication (ISO 8601)list_sections(publication?) -- list configured sections for a publication; required to publish on publications with sectionslist_drafts(limit?, publication?) -- list unpublished draftslist_published(limit?, publication?) -- list published posts with basic statsget_post(identifier, publication?) -- get full post by slug or numeric IDupload_image(image_path, publication?) -- upload an image to Substack CDN; returns CDN URLreact(post_id, publication?) -- heart a postrestack(post_id, publication?) -- restack a postcomment(post_id, body, publication?) -- comment on a postget_feed(limit?, publication?) -- your reader feed (posts from publications you follow)
Analytics
get_dashboard(days?, publication?) -- KPIs: total/paid subscribers, views, growth, ARRget_post_stats(post_id, publication?) -- views, opens, clicks, shares, conversions for one postget_subscriber_growth(publication?) -- subscriber count over timeget_growth_sources(publication?) -- subscriber growth by source (search, recommendations, direct, social)get_top_posts(limit?, publication?) -- posts ranked by engagementget_earnings(publication?) -- revenue data for paid publicationsget_recommendation_stats(direction?, publication?) -- recommendation network performancecapture_analytics_to_vault(publication?) -- write a weekly analytics snapshot to your vault
Install
Open Claude Code, paste:
/plugin marketplace add adelaidasofia/substack-mcp
/plugin install substack-mcp@substack-mcp
