Notion

Productivity Key required

GitHub stars4.7k

Forks638

LicenseMIT

Last activitySep 20, 2026

Open issues203

Repository: makenotion/notion-mcp-server · Data checked Oct 2026

About

Let your agent read and update your Notion pages and databases.

Details

npx -y @notionhq/notion-mcp-server

Checked by plugmyagent · Sep 19, 2026

Source Back to MCP

PlugMyAgent ScorecardChecked Oct 2026

Well kept

Actively maintained, a modest community, a key or two to set up.

MaintenanceStrong

Last commit Sep 20, 2026.

Community adoptionFair

4.7k GitHub stars.

Setup effortFair

Needs NOTION_API_KEY.

LicenseStrong

Open license: MIT.

Listing freshnessStrong

Checked by plugmyagent on Sep 19, 2026.

Rules: Methodology · Scores are never sold or adjusted for anyone.

Config for your agent

Pick your agent and copy the block into its MCP config file. The setup guide shows where that file lives for each agent.

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

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

[mcp_servers.notion]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
env = { NOTION_API_KEY = "your-token" }

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

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

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

[mcp_servers.notion]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
env = { NOTION_API_KEY = "your-token" }

{
  "servers": {
    "notion": {
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "command": "npx",
      "env": {
        "NOTION_API_KEY": "your-token"
      }
    }
  }
}

How to use it

Copy the config block above for your agent.
Paste it into your agent's MCP config file.
Restart your agent so it picks up the new server.
Ask your agent to use it.

Before you install

Is it free?: Yes. Notion is open source under the MIT license and free to run. It needs an API key from the provider; a free account or free tier covers normal use.
What do I need first?: Node.js 18 or newer (which provides npx); values for NOTION_API_KEY (they go in the env block of the config).

If it does not show up

Fully quit and relaunch your agent app after editing the config. Closing the window is not always enough for desktop apps.
Check the JSON is valid: one trailing comma breaks the whole file. Our MCP Config Validator checks it in your browser.
If the log says "npx: command not found", the runtime above is missing or the app cannot see your PATH. Install it, then relaunch the app.
If the server starts but every call fails, a credential is usually wrong or expired: NOTION_API_KEY.