> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://notion.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server.

# Comments API

Today we're launching a brand new set of APIs for interacting with Notion comments. This includes the ability to:

- Read comments from a page or block.
- Add a comment to a page.
- Add a comment to an existing discussion thread on a block.

For more information, check out the new [guide](/docs/working-with-comments) or dive straight into the [API reference](/reference/create-a-comment).