Notion

Notion

Interact with Notion API.

836
Stars
153
Forks
10
Releases

Overview

Notion MCP Server is a modular MCP server that exposes the Notion API to large language models, enabling seamless interaction with Notion workspaces via Claude Desktop. It authenticates with NOTION_API_TOKEN and can optionally enable experimental Markdown conversion to reduce token usage. The server comprises a client wrapper for Notion API calls, a Claude-facing MCP server, type definitions, utilities, and a markdown converter. It ships a broad tool suite covering blocks, pages, databases, users, and search (e.g., notion_retrieve_page, notion_update_page_properties, notion_query_database, notion_create_comment, notion_retrieve_comments, notion_retrieve_user, etc.). Markdown conversion returns responses as Markdown when format is 'markdown' and NOTION_MARKDOWN_CONVERSION is true, otherwise JSON; this trade-off preserves readability but may affect editing of page content. Configuration is done via claude_desktop_config.json, with two runtime options: using npx to fetch @suekou/mcp-notion-server or running a built file via node. The project is modular and designed to support flexible Notion-based LLM workflows.

Details

Owner
suekou
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Notion API MCP Server

Modular MCP server that exposes the Notion API to LLMs for workspace interactions.

Markdown Conversion for Token Efficiency

Experimental Markdown conversion reduces token usage and improves readability; may affect editing.

Per-request Output Format Control

Supports per-request format with format=json or format=markdown to control output.

Extensive Notion Tool Suite

Includes a broad set of Notion tools for blocks, pages, databases, users, comments, and search.

Environment-based Authentication

Uses NOTION_API_TOKEN for authentication, configured in claude_desktop_config.json or environment.

Flexible Deployment Options

Run via npx with @suekou/mcp-notion-server or run a built file with Node.

Modular Project Architecture

Codebase structured into client, server, types, utils, and markdown modules for maintainability.

Audience

DevelopersBuild and deploy MCP-based Notion integrations for LLM-powered workflows efficiently.
Notion usersUse MCP server to automate Notion tasks via LLM prompts.

Tags

NotionMCPNotion APIMarkdownClaude DesktopLLMtoken optimizationNotion toolsblockpagedatabaseauthenticationenvironment variablesconfigJSON/Markdown formatsNotion integrationNotion markdown conversion