notion-mcp-server

MostafaSwaisy/notion-mcp-server

3.2

If you are the rightful owner of notion-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server designed to integrate with Notion workspaces, providing a RESTful API for managing pages.

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

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"
      }
    }
  }
}