← Back to MCP Server for Notion

Install MCP Server for Notion

Pick your client, copy the command, done.

database
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/acckkiie/mcp-notion
cd mcp-notion
npm install
2

Register it in Claude Code

claude mcp add -e "NOTION_API_KEY=${NOTION_API_KEY}" -e "HOST_WORKSPACE_PATH=${HOST_WORKSPACE_PATH}" mcp-notion -- node /path/to/mcp-notion/build/index.js

Replace any placeholder paths in the command with the real path on your machine.

Required:NOTION_API_KEYHOST_WORKSPACE_PATH

Environment Variables

Set these before running MCP Server for Notion.

VariableDescriptionRequired
NOTION_API_KEYYour Notion integration secret key.Yes
HOST_WORKSPACE_PATHLocal path for file-based operations to save/load page content.Yes

Available Tools (5)

Once configured, MCP Server for Notion gives your AI agent access to:

searchSearch for Notion pages and databases.
query
retrieveRetrieve content from a specific Notion page or database.
id
createCreate a new page or database entry in Notion.
parent_idproperties
updateUpdate an existing Notion page or database entry.
idproperties
append_blockAppend new blocks to a Notion page.
page_idblocks

Try It Out

After setup, try these prompts with your AI agent:

→Search for the project roadmap page in my Notion workspace.
→Retrieve the content of the 'Meeting Notes' database entry from yesterday.
→Create a new task page in the 'Engineering' database with the title 'Fix API bug'.
→Append a summary of our recent discussion to the 'Project Alpha' page.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • Docker installed and running
  • NOTION_API_KEY — Your Notion integration secret key.
  • HOST_WORKSPACE_PATH — Local path for file-based operations to save/load page content.
Alternative installation methods

Docker

npm run build && docker build -t mcp-notion:latest .

Keep this setup from going cold

Save the docs, env vars, and workflow around MCP Server for Notion in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← MCP Server for Notion overview Browse database servers →