About Notion
Pages, databases, comments, workspace search
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
Endpoint
https://mcp.notion.com/mcpCopy install command
Claude CodeTerminal
claude mcp add --transport http notion https://mcp.notion.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"notion":{"type":"http","url":"https://mcp.notion.com/mcp"}}}Open in CursorVS Code.vscode/mcp.json
{"servers":{"notion":{"type":"http","url":"https://mcp.notion.com/mcp"}}}Open in VS CodeClaude Desktopclaude_desktop_config.json
{"mcpServers":{"notion":{"type":"http","url":"https://mcp.notion.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"notion":{"serverUrl":"https://mcp.notion.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
All endpoints
Streamable HTTP
https://mcp.notion.com/mcpSSE
https://mcp.notion.com/sseTools
28| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Semantic search query over your entire Notion workspace and connected sources (Slack, Google Drive, Github, Jira, Microsoft Teams, Sharepoint, OneDrive, or Linear). For best results, don't provide more than one question per tool call. Use a separate "search" tool call for each search you want to perform. Alternatively, the query can be a substring or keyword to find users by matching against their name or email address. For example: "john" or "[email protected]" |
| query_type | enum | No | Specify type of the query as either "internal" or "user". Always include this input if performing "user" search.internal | user |
| content_search_mode | enum | No | Select search backend: "workspace_search" (faster, workspace-only) or "ai_search" (semantic, includes Slack/Linear/etc.). If omitted, uses AI search if available. Content searches only.workspace_search | ai_search |
| data_source_url | string | No | Optionally, provide the URL of a Data source to search. This will perform a semantic search over the pages in the Data Source. Note: must be a Data Source, not a Database. <data-source> tags are part of the Notion flavored Markdown format returned by tools like fetch. The full spec is available in the create-pages tool description. |
| page_url | string | No | Optionally, provide the URL or ID of a page to search within. This will perform a semantic search over the content within and under the specified page. Accepts either a full page URL (e.g. https://notion.so/workspace/Page-Title-1234567890) or just the page ID (UUIDv4) with or without dashes. |
| teamspace_id | string | No | Optionally, provide the ID of a teamspace to restrict search results to. This will perform a search over content within the specified teamspace only. Accepts the teamspace ID (UUIDv4) with or without dashes. |
| filters | object | No | Optionally provide filters to apply to the search results. Only valid when query_type is 'internal'. |
| filters.created_date_range | object | No | Optional filter to only produce search results created within the specified date range. |
| filters.created_date_range.start_date | string | No | The start date of the date range as an ISO 8601 date string, if any. |
| filters.created_date_range.end_date | string | No | The end date of the date range as an ISO 8601 date string, if any. |
| filters.created_by_user_ids | array | No | Optional filter to only produce search results created by the Notion users that have the specified user IDs. |
| page_size | integer | No | Maximum number of results to return (default 10). Lower values reduce response size. |
| max_highlight_length | integer | No | Maximum character length for result highlights (default 200). Set to 0 to omit highlights entirely. |
Details
The maintainer has not added details yet. Check the README in the repository.
Comments
Markdown supported
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.