SkillFoxx

Type a name, a task or a service

Notion MCP Server

A Notion MCP server: the agent searches, reads, queries and updates workspace pages and databases

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Writes and updates real Notion pages and databases
  • Handles a workspace access token
All reasons and checks

suekou/mcp-notion-serverAuthor:suekou

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/suekou-mcp-notion-server

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'NOTION_API_TOKEN=<your NOTION_API_TOKEN>' notion -- npx -y @suekou/mcp-notion-server

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"notion","type":"stdio","command":"npx","args":["-y","@suekou/mcp-notion-server"],"env":{"NOTION_API_TOKEN":"<your NOTION_API_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "notion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add notion --env 'NOTION_API_TOKEN=<your NOTION_API_TOKEN>' -- npx -y @suekou/mcp-notion-server

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.notion]
command = "npx"
args = ["-y", "@suekou/mcp-notion-server"]
env = { NOTION_API_TOKEN = "<your NOTION_API_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "notion": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "environment": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<your NOTION_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

NOTION_API_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit efa09a2.

Text for your agent

Add the MCP server: npx -y @suekou/mcp-notion-server and set NOTION_API_TOKEN to the integration token. The user creates the token in the Notion integrations dashboard.

Other ways from the author
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Create the token in the Notion integrations dashboard.

This is third-party code. Review the repository files before installing.

What it does

The server connects the agent to the Notion API and keeps responses compact for day-to-day work. The agent searches pages and targets via notion_find, reads pages with stable block IDs, inspects data source schemas and runs schema-aware queries, and creates items with simple values. There are simple editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks and safe Markdown append, plus raw API calls for advanced block, page, database, comment and user operations. It targets Notion's current database and data source model and can return structured results, prompts and resources, plus optional interactive apps.

Who it is for. For teams and specialists who keep documents and databases in Notion and want to manage them through an agent.

Good fit when

  • You need the agent to search and read Notion pages
  • You need to query databases and create items
  • You need to edit pages or append content from the agent

Not a fit when

  • You have no Notion integration and token
  • You cannot give the agent access to the workspace

Example request

Find the tasks database in Notion and add a new task due Friday

Limitations

It needs a Notion internal integration token and only sees what the integration is granted. Read, insert and update permissions are set on the integration, so grant only what is needed. Update operations change real pages and databases.

How to disable. Remove the notion server from your MCP config and optionally disable the integration in Notion.

MCP

Transport
stdio
Authentication
API key
Environment variables
NOTION_API_TOKEN
required, secret		Notion internal integration token with the needed read, insert and update rights

Security check

  • Writes and updates real Notion pages and databases
  • Handles a workspace access token

README in short

The README describes an MCP server for the Notion API that helps an agent search, read, query and update workspaces while keeping responses compact. It targets the current database and data source model, offers editing tools, raw API calls and optional interactive apps. Install is via npx with a NOTION_API_TOKEN variable, with a guide for creating an integration and granting rights. MIT licensed.

FAQ

Where do I get the token?

Create an internal integration in the Notion integrations dashboard and grant it only the read, insert and update rights you need.

Can the server change data?

Yes, with the granted rights it creates and updates pages, blocks and database items.

Official

A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes

MCP serverMedium risk46.5K
Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31.2K
Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium riskNo VPN needed30.1K
Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K
Foxx AINotion MCP Server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.