Skip to main content
Glama
Notion MCP Server

Notion MCP Server

Notion MCP Server

A Model Context Protocol (MCP) server for Notion integration, providing AI assistants with secure access to Notion workspaces.

Features

  • Page Management: Create, read, update, and archive Notion pages

  • Search: Search across your Notion workspace

  • Block Operations: Append blocks and manage page content

  • User Management: Access workspace users and permissions

  • Resource Providers: Expose Notion content as MCP resources

Related MCP server: Notion MCP Server

Setup

  1. Install dependencies:

    npm install
  2. Set up Notion API:

  3. Configure environment:

    cp .env.example .env
    # Edit .env with your Notion API key
  4. Share pages with integration:

    • Go to your Notion pages

    • Share → Add people → Find your integration → Invite

Usage

Development

npm run dev

Production

npm run build
npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector

Tools Available

  • notion_get_page: Retrieve a page by ID

  • notion_create_page: Create a new page

  • notion_update_page: Update an existing page

  • notion_search: Search workspace content

  • notion_append_blocks: Add blocks to a page

  • notion_get_users: Get workspace users

  • notion_archive_page: Archive a page

Resources

  • notion://pages: Recent pages in workspace

  • notion://page/{id}: Specific page content

Integration with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["path/to/notion-mcp-server/dist/index.js"],
      "env": {
        "NOTION_API_KEY": "your_token_here"
      }
    }
  }
}

Available Tools

7 tools
notion_append_blocksC

Append blocks to a page

Inputs: blocks (required), pageId (required).

notion_archive_pageC

Archive a Notion page

Inputs: pageId (required).

notion_create_pageC

Create a new Notion page

Inputs: title (required), content, parentId.

notion_get_pageC

Retrieve a Notion page by ID

Inputs: pageId (required).

notion_get_usersC

Get workspace users

Inputs: no named parameters.

notion_update_pageC

Update an existing Notion page

Inputs: pageId (required), title, content.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have clearly distinct resource/action purposes. The main potential overlap is between notion_append_blocks and notion_update_page, but the descriptions reasonably clarify that one appends content blocks while the other updates page properties.

    Naming Consistency5/5

    All tools consistently use the notion_ prefix followed by a readable action-oriented name. The pattern is predictable throughout, with only minor variation in whether a noun follows the verb (e.g., notion_search).

    Tool Count5/5

    Seven tools is a well-scoped set for a focused Notion integration. Each tool corresponds to a core operation, and the count stays within a manageable range without obvious bloat.

    Completeness3/5

    Page lifecycle is mostly covered (create, get, update, archive, append blocks), but the surface lacks database operations, block retrieval/update/delete, and comment handling, which are significant gaps for a general Notion server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers