# WriteStack

> WriteStack is a Substack growth platform. Writers draft and schedule Substack Notes in their own voice, sync them to Substack through the WriteStack browser extension, write articles, get help from an AI Coach, and see which Notes brought subscribers.

How to use these docs:

- Find the task below under "Common tasks", or scan the page list. Links go to the Markdown version of each page; `#anchors` jump to the right section.
- Search: `GET https://docs.writestack.io/api/search?query=<words>` returns JSON matches (page and section URLs). Use it when the lists below don't name what you need.
- Any docs URL works as Markdown: add `.md`, or send `Accept: text/markdown`.
- Everything in one file: https://docs.writestack.io/llms-full.txt. The MCP tool reference in one file: https://docs.writestack.io/llms-mcp.txt.
- To act on a writer's account, connect to the MCP server at https://www.writestack.io/api/mcp/mcp (OAuth, or a bearer API key from Settings → MCP). Read the "Agent rules" page before calling tools.
- Notes scheduled over MCP are only queued in WriteStack. The writer must open WriteStack (My Notes → Scheduled notes) and click the yellow "Sync N scheduled notes to Substack" button so the browser extension pushes them to Substack.
- If the docs don't answer it, the writer can contact support: https://docs.writestack.io/docs/using/support.md

## Common tasks

- Get started / schedule a first Note: https://docs.writestack.io/docs/using/quickstart.md
- Connect or change the Substack publication: https://docs.writestack.io/docs/using/setup/connect-substack.md
- Install or update the browser extension: https://docs.writestack.io/docs/using/setup/browser-extension.md
- A Note didn't post / why didn't my Note post: https://docs.writestack.io/docs/using/concepts/sync.md#why-didnt-my-note-post
- What the yellow Sync button does: https://docs.writestack.io/docs/using/concepts/sync.md#the-yellow-sync-button
- An error message while scheduling or syncing: https://docs.writestack.io/docs/using/troubleshooting/sync-errors.md
- Notes post at the wrong time or in the wrong slot: https://docs.writestack.io/docs/using/troubleshooting/schedule-mismatch.md
- Can't connect Substack / connection errors: https://docs.writestack.io/docs/using/troubleshooting/substack-connection.md
- Write or draft a Note (AI in my voice): https://docs.writestack.io/docs/using/notes/drafting.md
- Import Notes from a CSV file: https://docs.writestack.io/docs/using/notes/drafting.md#import-notes-from-a-csv-file
- Add images, video or a link preview: https://docs.writestack.io/docs/using/notes/images-and-link-previews.md
- Create, assign or delete tags (categories): https://docs.writestack.io/docs/using/notes/tags.md
- Repeat a Note automatically (evergreen): https://docs.writestack.io/docs/using/notes/evergreen.md
- Auto-restack a Note after it publishes: https://docs.writestack.io/docs/using/notes/auto-restack.md
- Change my writing style / voice: https://docs.writestack.io/docs/using/concepts/writing-style.md#where-to-see-and-edit-it
- Add a Note to the queue: https://docs.writestack.io/docs/using/schedule/queue.md#add-one-note-at-the-next-available-time
- Schedule a Note at an exact time: https://docs.writestack.io/docs/using/schedule/queue.md#add-a-note-at-a-custom-time
- Reschedule / move / change the time of a scheduled Note: https://docs.writestack.io/docs/using/schedule/queue.md#move-a-scheduled-note
- Unschedule / cancel a scheduled Note: https://docs.writestack.io/docs/using/schedule/queue.md#unschedule-a-note
- Edit a Note that is already scheduled: https://docs.writestack.io/docs/using/schedule/queue.md#edit-a-scheduled-note
- Schedule many Notes at once: https://docs.writestack.io/docs/using/schedule/queue.md#schedule-many-notes-at-once
- Set up or edit weekly posting times: https://docs.writestack.io/docs/using/schedule/weekly-template.md
- Change or delete a posting time: https://docs.writestack.io/docs/using/schedule/weekly-template.md#edit-a-time
- Reserve a posting time for a tag: https://docs.writestack.io/docs/using/schedule/weekly-template.md#reserve-a-time-for-tags
- Change timezone: https://docs.writestack.io/docs/using/schedule/weekly-template.md#timezone
- How many Notes can I schedule (limit reached): https://docs.writestack.io/docs/using/concepts/capacity.md
- Cross-post Notes to LinkedIn, X, Threads… (Buffer): https://docs.writestack.io/docs/using/cross-posting.md
- Use the Coach (Quill): https://docs.writestack.io/docs/using/coach/what-it-does.md
- Coach usage limits / allowance ran out: https://docs.writestack.io/docs/using/coach/limits.md
- Write an article and push it to Substack: https://docs.writestack.io/docs/using/articles/substack-sync.md
- Which Notes brought subscribers / Notes stats: https://docs.writestack.io/docs/using/analytics/best-notes.md
- Reply to comments and mentions: https://docs.writestack.io/docs/using/activity-center.md
- Contact support: https://docs.writestack.io/docs/using/support.md
- Compare plans and limits: https://docs.writestack.io/docs/account/plans-and-limits.md
- Upgrade, downgrade or switch monthly/annual: https://docs.writestack.io/docs/account/change-plan.md
- Cancel my subscription: https://docs.writestack.io/docs/account/cancel.md
- Get an invoice or update the card: https://docs.writestack.io/docs/account/invoices.md
- Ask for a refund: https://docs.writestack.io/docs/account/refunds.md
- Free trial: https://docs.writestack.io/docs/account/trial.md
- Affiliate program or coupon codes: https://docs.writestack.io/docs/account/affiliates.md
- Connect Claude, ChatGPT, Notion or another AI to WriteStack: https://docs.writestack.io/docs/build.md
- Rules for AI agents using the MCP server: https://docs.writestack.io/docs/build/agent-rules.md
- MCP tool list: https://docs.writestack.io/docs/build/mcp-reference.md

## Using WriteStack

Schedule Notes, sync to Substack, write articles, work with the Coach, and read your analytics.

- [Introduction](https://docs.writestack.io/docs/using.md): Draft Substack Notes in your voice, queue them on a weekly schedule, sync them to Substack, and see which ones grow your audience.
- [Schedule your first Note](https://docs.writestack.io/docs/using/quickstart.md): Step-by-step from a new WriteStack account to a Note scheduled on Substack, including how to check it synced and posted.
- [Notes and the queue](https://docs.writestack.io/docs/using/concepts/notes-and-the-queue.md): The statuses a WriteStack Note can have (draft, ready, scheduled, published, evergreen), what each tab in My Notes shows, and what the queue is.
- [Tags and slots](https://docs.writestack.io/docs/using/concepts/tags-and-slots.md): How WriteStack picks a posting time for a Note, covering weekly slots, open versus reserved versus untagged-only times, OR tag matching, and what happens when no time fits.
- [Capacity](https://docs.writestack.io/docs/using/concepts/capacity.md): How many Notes you can have scheduled at once on each WriteStack plan, which Notes count toward the limit, and what happens when you reach it.
- [Sync](https://docs.writestack.io/docs/using/concepts/sync.md): How a scheduled Note gets from WriteStack to Substack, when you need to click the yellow Sync button, and the common reasons a Note didn't post.
- [Writing style](https://docs.writestack.io/docs/using/concepts/writing-style.md): What WriteStack saves about your voice, where to see and edit it (Settings → AI Settings), and how Note drafting, the Coach and AI assistants use it.
- [The Coach](https://docs.writestack.io/docs/using/concepts/the-coach.md): What the Coach (Quill) is, what it knows about your publication, and what it will and won't do without your approval.
- [Connect your Substack](https://docs.writestack.io/docs/using/setup/connect-substack.md): How WriteStack links to your Substack profile and publication during onboarding, what it reads, and how to change the publication later.
- [Add yourself as an author](https://docs.writestack.io/docs/using/setup/add-byline.md): Add your byline to a Substack post so WriteStack can find your publication during signup.
- [Install the browser extension](https://docs.writestack.io/docs/using/setup/browser-extension.md): How to install the WriteStack extension for Chrome or Firefox, what it does, which browsers work, and which extension version each feature needs.
- [Write a Note](https://docs.writestack.io/docs/using/notes/drafting.md): How to write a Substack Note in the WriteStack editor, including formatting, line breaks, AI help in your own voice, Draft and Ready statuses, importing Notes from a CSV file, and copying a Note.
- [Images, video and link previews](https://docs.writestack.io/docs/using/notes/images-and-link-previews.md): How to add images, GIFs and a video to a WriteStack Note, how the link preview card works (one per Note, the first link by default), and the size and count limits.
- [Tag a Note](https://docs.writestack.io/docs/using/notes/tags.md): How to create tags (called categories in the app), add them to a Note, and how a Note's tags decide which queue times it can take.
- [Evergreen Notes](https://docs.writestack.io/docs/using/notes/evergreen.md): How to make a WriteStack Note evergreen so it reposts every 1 to 4 weeks, how the reposts are scheduled up to 90 days ahead and refilled, and how to edit or remove an evergreen Note.
- [Auto-restack](https://docs.writestack.io/docs/using/notes/auto-restack.md): How to make WriteStack restack your own Note 1 to 168 hours after it publishes, for one Note or as a default for all new Notes, the extension version it needs, and how to turn it off.
- [Restack someone else's Note](https://docs.writestack.io/docs/using/notes/restack-someone-elses-note.md): How to restack or quote another writer's Substack Note from WriteStack by pasting the Note's URL into the editor, which turns it into a quote card, then removing the link from your text.
- [Weekly template](https://docs.writestack.io/docs/using/schedule/weekly-template.md): How to build your weekly posting template in WriteStack, including adding and editing times, picking days, reserving a time for tags or for untagged Notes, default cross-post channels on a time, and setting your timezone.
- [Manage the queue](https://docs.writestack.io/docs/using/schedule/queue.md): How to add Notes to the WriteStack queue at the next available time or a custom time, reschedule them (change the time or day), unschedule or cancel them, edit them after scheduling, schedule many Notes at once, and what to do with Notes that have no matching queue time.
- [Create an article](https://docs.writestack.io/docs/using/articles/create.md): How to create a long-form article draft in WriteStack (with the Coach or an AI agent over MCP), which newsletters it can go to, the Markdown formatting it supports, images and the planned date.
- [Push an article to Substack](https://docs.writestack.io/docs/using/articles/substack-sync.md): How a WriteStack article becomes a Substack draft, how to schedule and unschedule it on Substack, which Substack settings sync, what the browser extension needs, and what each sync status and error means.
- [How the Coach writes articles](https://docs.writestack.io/docs/using/articles/coach-articles.md): How the Coach (Quill) drafts a post, saves it as a WriteStack article, edits existing drafts and pushes them to Substack, and which steps wait for the writer.
- [What the Coach can do](https://docs.writestack.io/docs/using/coach/what-it-does.md): What the WriteStack Coach (Quill) knows about your publication, what it can draft, save and schedule for you, and how chats, Memory, Library and Routines work.
- [What needs your approval](https://docs.writestack.io/docs/using/coach/approvals.md): Which Coach (Quill) actions run as soon as you ask, which wait for you to confirm or choose on a card, which the Coach never does, and how to approve, decline or undo them.
- [Coach limits](https://docs.writestack.io/docs/using/coach/limits.md): How much you can use the WriteStack Coach (Quill) on each plan, when the weekly allowance resets, what happens when it runs out, other message and routine limits, and what the Coach can't do.
- [Notes analytics](https://docs.writestack.io/docs/using/analytics/notes-analytics.md): What the Statistics and Notes Performance pages show for your Substack Notes (impressions, interactions, free and paid subscribers, audience and surface mix), where the data comes from, and how to filter it by date.
- [Find your best Notes](https://docs.writestack.io/docs/using/analytics/best-notes.md): How to find the Substack Notes that brought you free and paid subscribers, impressions and replies in WriteStack, and how to use them to write more Notes that work.
- [Posts Statistics](https://docs.writestack.io/docs/using/analytics/posts-statistics.md): What WriteStack's Posts Statistics page shows for your Substack newsletter posts (subscribers, ARR, open rate, email traffic, delivery, views, likes, free and paid subs per post), how open rate differs from email traffic, and the extension version it needs.
- [Activity Center](https://docs.writestack.io/docs/using/activity-center.md): How to use WriteStack's Activity Center to see Substack comments, mentions and restacks in one feed, filter and sort them, reply, like or restack with keyboard shortcuts, and auto-handle notifications.
- [Cross-posting with Buffer](https://docs.writestack.io/docs/using/cross-posting.md): How to cross-post Substack Notes from WriteStack to X, LinkedIn, Instagram, Threads, Facebook, Bluesky and more through Buffer, with channels per Note or per schedule time, per-channel text and images, limits, and when cross-posts are sent.
- [Ghostwriter](https://docs.writestack.io/docs/using/ghostwriter.md): What WriteStack's Ghostwriter mode is (writing and scheduling Substack Notes for client accounts) and how to get access to it.
- [Substack connection problems](https://docs.writestack.io/docs/using/troubleshooting/substack-connection.md): Fixes for errors when connecting your Substack profile in onboarding, when Notes post from the wrong account, and when the extension can't reach your Substack.
- [Sync errors](https://docs.writestack.io/docs/using/troubleshooting/sync-errors.md): Fixes for scheduled Notes that didn't reach Substack or didn't post, a missing Sync button, extension not detected, scheduling limits and Substack rate limits.
- [Notes post at the wrong time](https://docs.writestack.io/docs/using/troubleshooting/schedule-mismatch.md): Why a Note posts at an unexpected time or lands in a different queue slot than you expected, and how to fix time zones, tag routing, unmatched notes and queue edits.
- [Get help](https://docs.writestack.io/docs/using/support.md): How to reach WriteStack support through the in-app chat or email, what to include so we can fix your problem fast, and where to suggest features.

## Account & billing

Plans and limits, trials, upgrades, cancelling, invoices, refunds and affiliates.

- [Account & billing](https://docs.writestack.io/docs/account.md): Where to find WriteStack plans, limits, the free trial, plan changes, cancelling, invoices, refunds and the affiliate program.
- [Plans and limits](https://docs.writestack.io/docs/account/plans-and-limits.md): What each WriteStack plan (Hobbyist, Standard, Enterprise) includes, with limits for queued Notes, Coach usage, AI credits, cross-post channels and statistics.
- [Free trial](https://docs.writestack.io/docs/account/trial.md): How long the WriteStack free trial lasts, whether you need a card, what it includes, and what happens when it ends.
- [Change your plan](https://docs.writestack.io/docs/account/change-plan.md): How to upgrade or downgrade your WriteStack plan, switch between monthly and annual billing, and what happens to billing and limits when you do.
- [Cancel your subscription](https://docs.writestack.io/docs/account/cancel.md): How to cancel WriteStack, how long you keep access, and what happens to your Notes and scheduled Notes after the subscription ends.
- [Invoices and payment method](https://docs.writestack.io/docs/account/invoices.md): How to download WriteStack invoices and receipts, update your card, and change the billing email, name, address or tax ID.
- [Refunds](https://docs.writestack.io/docs/account/refunds.md): WriteStack's refund policy for subscription payments and how to contact support about a charge.
- [Affiliates and coupon codes](https://docs.writestack.io/docs/account/affiliates.md): How to join the WriteStack ambassador (affiliate) program, how commission and payouts work, and how customers use coupon codes at checkout.

## Build with WriteStack

Connect Claude, ChatGPT, Notion or your own agent over MCP. Full tool reference.

- [Build with WriteStack](https://docs.writestack.io/docs/build.md): What the WriteStack MCP server is, what an AI agent can do with it, and where to start.
- [Agent rules](https://docs.writestack.io/docs/build/agent-rules.md): The rules every AI agent must follow when calling the WriteStack MCP server, including the manual Sync step, capacity checks and read-before-write.
- [Connect Claude](https://docs.writestack.io/docs/build/connect/claude.md): Add WriteStack to Claude from the connector directory, as a custom connector, or through the Claude Desktop config file.
- [Connect ChatGPT](https://docs.writestack.io/docs/build/connect/chatgpt.md): Find WriteStack in ChatGPT's app directory, connect it, and sign in.
- [Connect Notion](https://docs.writestack.io/docs/build/connect/notion.md): Add WriteStack to Notion as a custom MCP connection so Notion AI can read and schedule your Notes.
- [Claude Code, Cursor and other coding agents](https://docs.writestack.io/docs/build/connect/claude-code.md): Add the WriteStack MCP server to Claude Code, Cursor, VS Code or any client that reads an MCP config file.
- [API key](https://docs.writestack.io/docs/build/connect/api-key.md): Create, use and revoke a WriteStack API key for MCP clients that don't support OAuth.
- [OAuth for MCP clients](https://docs.writestack.io/docs/build/connect/oauth.md): OAuth 2.1 endpoints, scopes and metadata for building an MCP client that connects to WriteStack.
- [All MCP tools](https://docs.writestack.io/docs/build/mcp-reference.md): Every tool the WriteStack MCP server exposes (29 in total), grouped by area, with what each does and whether it changes data.
- [list_notes](https://docs.writestack.io/docs/build/mcp-reference/list_notes.md): List Notes. List your notes, optionally filtered by status or tag.
- [get_note](https://docs.writestack.io/docs/build/mcp-reference/get_note.md): Get Note. Get a single note by ID with its full content, including auto-restack configuration (autoRestackAfterHours), Buffer cross-post channels (bufferChannelIds), and any per-channel Buffer post overrides (bufferChannelPosts: custom text and attachments for a channel).
- [get_writing_style](https://docs.writestack.io/docs/build/mcp-reference/get_writing_style.md): Get Writing Style. Return the user's saved note style, topics, and onboarding context from WriteStack (user metadata and linked publication analysis).
- [list_tags](https://docs.writestack.io/docs/build/mcp-reference/list_tags.md): List Tags. List all your note categories/tags.
- [create_note](https://docs.writestack.io/docs/build/mcp-reference/create_note.md): Create Note. Create a new note draft or ready note.
- [create_many_notes](https://docs.writestack.io/docs/build/mcp-reference/create_many_notes.md): Create Many Notes. Create multiple notes at once.
- [update_note](https://docs.writestack.io/docs/build/mcp-reference/update_note.md): Update Note. Update an existing note's content, status, tags, auto-restack delay (autoRestackAfterHours), Buffer cross-post channels (bufferChannelIds), per-channel Buffer posts (bufferChannelPosts), or link preview (includePreviews).
- [get_schedule](https://docs.writestack.io/docs/build/mcp-reference/get_schedule.md): Get Schedule. Get your recurring schedule template (weekly time slots).
- [get_queue](https://docs.writestack.io/docs/build/mcp-reference/get_queue.md): Get Queue. Get the scheduled notes queue (notes with assigned schedule times).
- [get_next_available_slots](https://docs.writestack.io/docs/build/mcp-reference/get_next_available_slots.md): Get Next Available Slots. Get the next N available posting slots based on your schedule template and already-scheduled notes.
- [get_schedule_capacity](https://docs.writestack.io/docs/build/mcp-reference/get_schedule_capacity.md): Get Schedule Capacity. Check how many more notes the user is allowed to schedule on their current plan.
- [schedule_notes](https://docs.writestack.io/docs/build/mcp-reference/schedule_notes.md): Schedule Notes. Schedule notes to the user's next available posting slots based on their recurring schedule template.
- [schedule_notes_with_custom_dates](https://docs.writestack.io/docs/build/mcp-reference/schedule_notes_with_custom_dates.md): Schedule Notes With Custom Dates. Schedule notes at user-provided custom dates/times (one date per note).
- [list_article_newsletters](https://docs.writestack.io/docs/build/mcp-reference/list_article_newsletters.md): List Article Newsletters. List the newsletters the user has enabled for Articles (the ones shown in WriteStack Articles; hidden newsletters are omitted).
- [list_articles](https://docs.writestack.io/docs/build/mcp-reference/list_articles.md): List Articles. List WriteStack articles from newsletters the user has enabled in Articles, optionally filtered by status or publicationId.
- [get_article](https://docs.writestack.io/docs/build/mcp-reference/get_article.md): Get Article. Get one WriteStack article by ID, including markdown body, publicationId, contentVersion, and Substack draft/schedule status.
- [create_article](https://docs.writestack.io/docs/build/mcp-reference/create_article.md): Create Article. Create a WriteStack article draft.
- [update_article](https://docs.writestack.io/docs/build/mcp-reference/update_article.md): Update Article. Update an article's title, subtitle, markdown body, imageUrl (remote images fetched to S3 and appended), or Substack settings (audience, comments, SEO, slug, social title, publishAt).
- [create_article_image_upload](https://docs.writestack.io/docs/build/mcp-reference/create_article_image_upload.md): Create Article Image Upload. Get one-time upload URLs on writestack.io for an article image that has no public URL, such as a local file, an attachment you can read, or a private Google Drive file.
- [push_article_to_substack](https://docs.writestack.io/docs/build/mcp-reference/push_article_to_substack.md): Push Article To Substack. Push or update a WriteStack article as a Substack draft through the user's Chrome extension.
- [schedule_article_on_substack](https://docs.writestack.io/docs/build/mcp-reference/schedule_article_on_substack.md): Schedule Article On Substack. Schedule a WriteStack article on Substack.
- [unschedule_article_on_substack](https://docs.writestack.io/docs/build/mcp-reference/unschedule_article_on_substack.md): Unschedule Article On Substack. Remove a WriteStack article from the Substack schedule.
- [get_article_substack_status](https://docs.writestack.io/docs/build/mcp-reference/get_article_substack_status.md): Get Article Substack Status. Get the Substack sync status for an article: draft URL, scheduled time, and last error if any.
- [get_notes_statistics](https://docs.writestack.io/docs/build/mcp-reference/get_notes_statistics.md): Get Notes Statistics. Analyze the user's published Substack notes analytics: returns a paginated batch of notes with engagement metrics (impressions, clicks, reactions, comments, restacks, profile visits, shares, free/paid subscribers) and an audience split (subscribers, followers, strangers) when Substack stored one.
- [get_posts_statistics](https://docs.writestack.io/docs/build/mcp-reference/get_posts_statistics.md): Get Posts Statistics. Read this writer's Substack post statistics for every newsletter selected on Posts Statistics, in one call.
- [list_activities](https://docs.writestack.io/docs/build/mcp-reference/list_activities.md): List Activities. List activity on the user's Substack (same rules as the WriteStack activity feed): non-dismissed items, excluding the user's own author, optional filter (all / comments / mentions).
- [list_buffer_channels](https://docs.writestack.io/docs/build/mcp-reference/list_buffer_channels.md): List Buffer Channels. List the user's connected Buffer channels (social accounts like LinkedIn, X/Twitter, Threads, etc.) available for cross-posting.
- [ask_coach](https://docs.writestack.io/docs/build/mcp-reference/ask_coach.md): Ask Coach. Talk to the WriteStack Coach (Quill), the user's Substack growth coach.
- [get_feature_suggestion_link](https://docs.writestack.io/docs/build/mcp-reference/get_feature_suggestion_link.md): Get Feature Suggestion Link. Return the link to the WriteStack features board, where the user can post a product or feature idea for others to vote on.
- [Recipes](https://docs.writestack.io/docs/build/recipes.md): Ready-to-use prompts for AI agents connected to WriteStack, with the tools each one calls, in order.
- [API](https://docs.writestack.io/docs/build/api.md): WriteStack does not have a public REST API yet. Use the MCP server to automate WriteStack today.

## Optional

- [WriteStack app](https://www.writestack.io): Sign up and log in
- [App llms.txt](https://www.writestack.io/llms.txt): Product overview for agents
- [MCP tool list (JSON)](https://docs.writestack.io/mcp-tools.json): Every MCP tool with its input and output JSON Schema