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

# Guides

## Docs

- [Notion API Overview](https://notion.ferndocs.com/docs/getting-started.md): Discover how to leverage Notion's Public API to build integrations.
- [Build your first integration](https://notion.ferndocs.com/docs/create-a-notion-integration.md): Make your first request to the Notion API.
- [Authorization](https://notion.ferndocs.com/docs/authorization.md): This guide describes the authorization flows for internal and public Notion integrations.
- [Publishing to Notion’s Integration Gallery](https://notion.ferndocs.com/docs/publishing-integrations-to-notions-integration-gallery.md): 
- [Upgrading to Version 2025-09-03](https://notion.ferndocs.com/docs/upgrade-guide-2025-09-03.md): Learn how to upgrade your Notion API integrations to the latest API version
- [FAQs: Version 2025-09-03](https://notion.ferndocs.com/docs/upgrade-faqs-2025-09-03.md): Commonly asked questions about data sources and how to migrate to Notion's API version 2025-09-03
- [Notion MCP](https://notion.ferndocs.com/docs/mcp.md): Learn how to connect AI agents to your Notion workspace.
- [Connecting to Notion MCP](https://notion.ferndocs.com/docs/get-started-with-mcp.md): Learn how to get started and plug Notion into your AI tool.
- [Supported tools](https://notion.ferndocs.com/docs/mcp-supported-tools.md): Learn what you can do with Notion MCP tools.
- [Security best practices](https://notion.ferndocs.com/docs/mcp-security-best-practices.md): Learn how to keep your workspace secure when using Notion MCP.
- [Hosting a local MCP server](https://notion.ferndocs.com/docs/hosting-open-source-mcp.md): Learn how and when to use the open-source Notion MCP server.
- [Common MCP clients](https://notion.ferndocs.com/docs/common-mcp-clients.md): 
- [Working with page content](https://notion.ferndocs.com/docs/working-with-page-content.md): Learn about page content and how to add or retrieve it with the Notion API.
- [Working with databases](https://notion.ferndocs.com/docs/working-with-databases.md): Learn about data source schemas, querying data sources, and more.
- [Working with comments](https://notion.ferndocs.com/docs/working-with-comments.md): Learn how to add and retrieve comments with the Notion API.
- [Working with files and media](https://notion.ferndocs.com/docs/working-with-files-and-media.md): Learn how to add or retrieve files and media from Notion pages.
- [Uploading small files](https://notion.ferndocs.com/docs/uploading-small-files.md): Learn how to send and attach files up to 20 MB using the Notion API.
- [Retrieving existing files](https://notion.ferndocs.com/docs/retrieving-files.md): Learn how to get a download link for files in the Notion API.
- [Uploading larger files](https://notion.ferndocs.com/docs/sending-larger-files.md): Learn how to send files larger than 20 MB in multiple parts.
- [Importing external files](https://notion.ferndocs.com/docs/importing-external-files.md): Learn how to migrate files from an external URL to Notion.
- [Introduction](https://notion.ferndocs.com/docs/link-previews.md): This guide introduces Link Previews, how they work, and what you need to build them.
- [Build a Link Preview integration](https://notion.ferndocs.com/docs/build-a-link-preview-integration.md): Follow this step-by-step guide to create your first Link Preview.
- [Best practices for handling API keys](https://notion.ferndocs.com/docs/best-practices-for-handling-api-keys.md): Learn how to manage and secure your Notion API tokens.
- [Historical changelog](https://notion.ferndocs.com/docs/historical-changelog.md): View an archive of Notion Developers updates prior to September 2023
- [Historical changelog (all entries)](https://notion.ferndocs.com/docs/historical-changelog/llms.txt)