Use Notion with AI via MCP
Many companies keep their knowledge in Notion: handbooks, project documentation, meeting notes and databases live in a deeply nested page structure. The official Notion MCP server makes all of it searchable for agents in CompanyGPT – with each user's own permissions.
What is Notion?
Notion, built by Notion Labs, combines documents, wikis and databases in a single tool. Pages nest freely, content can be shown as a table, board or calendar, and records link to each other through relations. Small teams use it as a lightweight wiki, larger organizations as a central knowledge base.
That flexibility has a downside: the more a workspace grows, the harder it becomes to find a specific piece of information. For AI agents, Notion is therefore an especially rewarding source – content already carries structure and metadata, which makes targeted search, summarization and even writing into databases straightforward.
Connection at a Glance
- MCP server
- Official (Notion), remote – self-hosting available
- Endpoint
- mcp.notion.com/mcp
- Transport
- Streamable HTTP
- Authentication
- OAuth (remote) or integration token (self-hosted)
- Operating model
- SaaS
- Permissions
- Per user – Notion page sharing stays in effect
How to Connect Notion to CompanyGPT
Notion runs an official hosted MCP server at mcp.notion.com/mcp, reachable over streamable HTTP. CompanyGPT connects directly to this endpoint, and users sign in via OAuth with their own Notion account. The agent therefore sees exactly the pages and databases available to that user in the workspace.
If you would rather keep the traffic entirely inside your own environment, there is a second option: an npm package for self-hosting exists – though it is an older, no longer actively maintained open-source package that builds on the older JSON v1 API. In that setup we run the server as a container inside your CompanyGPT environment, and authentication uses an integration token instead of the OAuth flow. The remote connection remains the recommended route; which variant fits best is something we determine together, based on your security requirements.
Either way, your administrators in CompanyGPT use roles and groups to decide who may use the Notion integration, and define per agent which tools – search and read operations only, for example – are available.
Typical Use Cases
How AI agents in CompanyGPT work with Notion
Answers from the internal wiki
New joiners ask in chat about leave policy, approval processes or tool access – the agent answers from the shared Notion pages and cites the source pages.
Analyze project databases
Project management has the status of all active initiatives compiled from a Notion database, filtered by owner or due date.
File notes in the right place
Outcomes from a conversation land as a new record in the matching Notion database, with properties such as customer, topic and next step already filled in.
Frequently Asked Questions
Notion and AI – the most important answers
Does Notion have an official MCP server?
Yes. Notion provides an official hosted MCP server at mcp.notion.com/mcp, connected via streamable HTTP. For self-hosting there is additionally an older, no longer actively maintained open-source npm package that uses the older JSON v1 API.
What speaks in favor of the self-hosted variant?
When self-hosted, the MCP server runs as a container inside your own CompanyGPT environment. Requests only leave your tenant when the Notion API itself is called – for organizations with strict data handling requirements, that is often the deciding factor. Bear in mind that the npm package required for this is older, no longer actively maintained and uses the older JSON v1 API; the remote connection therefore remains our recommendation.
Does the AI see our entire Notion workspace?
No. With the remote connection, each user signs in via OAuth with their own account and only sees pages shared with them. In the self-hosted setup, the scope of the configured integration token determines what is reachable.
Can the agent create or edit pages?
In principle yes, provided the corresponding tools are enabled. CompanyGPT lets you define per agent whether it may only read or also write.
What about data protection?
CompanyGPT runs in your own cloud tenant, and communication happens directly between your instance and the MCP server – without intermediaries. Assessing Notion as a vendor continues to follow your existing Notion contract.
Related Integrations
Project Management & Collaboration
Notion and Your AI – GDPR-Compliant with CompanyGPT
CompanyGPT is the enterprise AI assistant in your own cloud tenant: all relevant AI models, your company data and integrations like Notion – centrally managed, with roles and permissions. We set up the connection together with you.
Notion is a trademark of its respective owner (Notion Labs, Inc.). Its mention describes compatibility and does not imply any partnership or endorsement. Availability and scope of the connection depend on the respective vendor.