Notion
The official Notion MCP server connects AI assistants to your Notion workspace so they can search pages and databases, read and write page content as Markdown, create and move pages, manage comments, and query, create, and update Notion data sources and their schemas.
Install Notion
- Published by
- Official (vendor)
- Transport
- Remote (HTTP)
- Authentication
- OAuth
Claude Desktop, Claude Code and Cursor
Add this to the mcpServers object in your client's
config file, then restart the client.
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}VS Code uses a different key — show that config
Identical entry, filed under servers rather than
mcpServers. Put it in
.vscode/mcp.json for one workspace.
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}Before it will answer
Hosted by Notion, so nothing runs locally. After you authorise with OAuth the agent can read and update exactly the content your own account can reach — sharing a page with the integration is what grants access, not the connection itself.
Tools
create-a-data-source
Create a new Notion data source, i.e. a database, in the workspace.
create-comment
Add a comment to a Notion page or discussion thread.
create-page
Create a new Notion page under a chosen parent location.
list-data-source-templates
List the available templates in a Notion data source.
move-page
Move a Notion page to a different parent page or database.
query-data-source
Query a Notion data source (database) with filters and sorts.
retrieve-a-database
Get database metadata including its data source IDs.
retrieve-a-data-source
Get the metadata and schema for a Notion data source.
retrieve-page
Retrieve the properties and metadata of a Notion page.
retrieve-page-markdown
Read a Notion page's full content rendered as Markdown.
search
Search for pages and data sources across the Notion workspace.
update-a-data-source
Update the properties of an existing Notion data source.
update-page
Update the properties of an existing page in your Notion workspace.
update-page-markdown
Edit the body content of a Notion page using Markdown input.