Notion MCP Server

MCP Server Configuration

Copy
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "<your-integration-token>",
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer <your-integration-token>\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Available Tools

Tool	Description
search	Search across all pages and databases
get_page	Retrieve a page and its properties
create_page	Create a new page in a database or as a subpage
update_page	Update page properties
get_block_children	Get content blocks of a page
append_block_children	Add content to a page
query_database	Query a database with filters and sorts
create_database	Create a new database
get_database	Get database schema and properties
list_users	List workspace members
create_comment	Add a comment to a page or discussion

Setup

1. Create an integration at https://www.notion.so/my-integrations
2. Copy the "Internal Integration Token" (starts with ntn_)
3. Share pages/databases with your integration:
   • Open the page in Notion
   • Click "..." menu > "Connections" > Add your integration
4. Replace <your-integration-token> in both places in the config

Usage Examples

• "Search Notion for our API design decisions"
• "Add today's meeting notes to the Engineering Wiki"
• "Query the sprint backlog database for unfinished tasks"
• "Create a new page documenting the auth flow changes"
• "Update the deployment checklist with the new steps"

Security Notes

• Integration tokens grant read/write access to shared pages only
• Pages must be explicitly shared with the integration
• Store tokens in .claude/settings.local.json (gitignored)
• The integration can only access content you explicitly share with it
• Review write operations before approving to prevent unwanted edits