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:

   • Go to Notion Developers
   • Create a new integration
   • Copy the integration token

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