What it does
Notion's official MCP server exposes the Notion API as tools for Claude, enabling AI agents to query databases and data sources, create and update pages in Markdown, search workspace content, and manage page hierarchies and metadata. It implements Notion API version 2025-09-03, which refactored database operations around data sources as the primary abstraction.
Who it's for
Backend engineers integrating Notion into data pipelines, product managers automating status updates and summaries, and teams building knowledge bases that Claude can query and augment with analysis.
Common use cases
- Query a Notion database or data source and summarize findings for a report
- Create new Notion pages with analysis, research notes, or meeting summaries generated by Claude
- Search your Notion workspace for context on a topic before answering a question
- Update data source properties, filter and sort databases, and reorganize pages across sections
- Move pages between parent locations and modify page metadata from Claude
Setup pitfalls
- Requires a Notion API token (
NOTION_TOKENenv var) from an internal integration. Store it securely — never hardcode it or commit it to version control. - The integration must be explicitly granted access to pages and databases via Notion's integration Access tab. Without access grants, the server cannot read or modify workspace content.
- Version 2.0.0 introduced breaking changes: database tools (
post-database-query,update-a-database,create-a-database) were removed in favor of data source tools. Update any hardcoded tool names or prompts that reference the old tools. - Notion is deprioritizing this local repository in favor of its remote MCP server. Active support is waning; report bugs to Notion support, not the GitHub repo.