Atlas / MCP servers / ccabanillas / Notion

NotionCAUTION

Name: Notion
Author: ccabanillas

mcp/ccabanillas/notion-4

MCP server by ccabanillas · Audited 2026-10-07

A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion's API.

Verdict

CAUTION

Grade

Trust score

88 /100

Exposed tools

7 5r · 2w · 0d

Transport

stdio

License

MIT

Stars

111

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://smithery.ai/server/@ccabanillas/notion-mcp)

A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion's API. Compatible with Claude Desktop and other MCP clients.

Features

List and query Notion databases
Create and update pages
Search across Notion workspace
Get database details and block children
Full async/await support with httpx
Type-safe with Pydantic v2 models
Proper error handling with detailed logging
Compatibility with MCP 1.6.0

Installation

Installing via Smithery

To install Notion Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ccabanillas/notion-mcp --client claude

Manual Installation

Clone the repository:

git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp

Create a virtual environment and install dependencies (using uv):

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Alternatively, using standard venv:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .

Create a .env file in the project root:

NOTION_API_KEY=your_notion_integration_token

Usage

Test the server (it should run without errors):

python -m notion_mcp

To use it with Claude Desktop, adjust your claude_desktop_config.json file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
"servers": {
"notion-mcp": {
"command": "/Users/username/Projects/notion-mcp/.venv/bin/python",
"args": ["-m", "notion_mcp"],
"cwd": "/Users/username/Projects/notion-mcp"
}
}
}

Be sure to replace /Users/username/ with

Read from source at commit d147ce4ee908OBSERVED · 2026-10-07

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add notion-mcp --env NOTION_API_KEY=${NOTION_API_KEY} -- uvx notion-mcp

claude-desktop

{
  "mcpServers": {
    "notion-mcp": {
      "command": "uvx",
      "args": [
        "notion-mcp"
      ],
      "env": {
        "NOTION_API_KEY": "${NOTION_API_KEY}"
      }
    }
  }
}

Exposed tools (7)

5 read · 2 write · 0 destructive.

Tool	Risk	Description
`create_page`	write	Create a new page in a database
`get_block_children`	read	Get the children blocks of a block
`get_database`	read	Get details about a specific Notion database
`list_databases`	read	List all accessible Notion databases
`query_database`	read	Query items from a Notion database
`search`	read	Search Notion content
`update_page`	write	Update an existing page

Trust audit

CAUTIONgrade B · trust 88/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	WARN
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: none-observed
Network: declared (5 observation(s))
Shell: none-observed
Dependencies: pinned
Secrets in source: none-found

Findings (5)

MEDIUMInventory / provenance · inv.binary · CWE-1104

src/notion_mcp/__pycache__/__init__.cpython-311.pyc

__init__.cpython-311.pyc

Why it matters. a compiled or binary member cannot be reviewed from source