Notion MCP Server

Official Notion MCP server for workspace integration. Enables AI agents to search pages, read content, create new pages, update existing pages, and manage databases in Notion. Supports rich text content, database queries with filters, and page property management for seamless knowledge base interaction from AI-powered tools.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_API_KEY": "<YOUR_NOTION_API_KEY>"
      }
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query string"
    },
    "filter": {
      "type": "object",
      "properties": {
        "value": {
          "type": "string"
        },
        "property": {
          "type": "string"
        }
      },
      "description": "Optional filter criteria"
    }
  }
}

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Notion page ID"
    }
  }
}

{
  "type": "object",
  "required": [
    "parentId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Page title"
    },
    "content": {
      "type": "string",
      "description": "Page content in Markdown"
    },
    "parentId": {
      "type": "string",
      "description": "Parent page or database ID"
    },
    "properties": {
      "type": "object",
      "description": "Database properties to set"
    }
  }
}

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Page ID to update"
    },
    "content": {
      "type": "string",
      "description": "New content in Markdown"
    },
    "properties": {
      "type": "object",
      "description": "Properties to update"
    }
  }
}