mcp-server-notion

What is mcp-server-notion?

mcp-server-notion is an MCP server that uses the Notion API to search for articles on Notion and retrieve their contents. It allows developers to programmatically access article information from Notion databases.

How to use mcp-server-notion?

Configure the NOTION_API_TOKEN environment variable with your Notion integration token. The server provides two tools: notion_search (with parameters query and limit) and notion_get_article (with parameters article_id and format). Requires Python 3.13 or higher.

Key features of mcp-server-notion

• Search for articles within Notion databases
• Retrieve full article content or partial content
• Supports output formats: JSON, Markdown, plain text

Use cases of mcp-server-notion

• Build a custom search interface for your Notion knowledge base
• Integrate Notion article retrieval into an AI assistant workflow
• Automate content extraction from Notion for documentation or analysis

FAQ from mcp-server-notion

What are the prerequisites?

Python 3.13 or higher, a Notion API integration set up with proper permissions, and a Notion integration token.

How do I configure the server?

Set the environment variable NOTION_API_TOKEN to your Notion integration token. No other configuration is required.

What tools does mcp-server-notion provide?

Two tools: notion_search (accepts query and limit) and notion_get_article (accepts article_id and format).

What output formats are supported for article retrieval?

The notion_get_article tool supports json, markdown, and text formats.

Can I retrieve only part of an article?

Yes, the server can retrieve partial content, though the README does not specify how to limit content beyond the full retrieval.