Notion MCP Server by awkoy

by awkoy• 179•• Scanned•Claim this listing•Request removal
Productivity & Workflowai agentsanthropicchatgptclaudeclaude code

Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless.

Notion MCP Server is an open-source mcp server by awkoy, written mainly in TypeScript, with 179 GitHub stars and the MIT license. Its code was last updated Oct 28, 2026. The latest npm release is notion-mcp-server 3.4.0, published Nov 9, 2026, with 5,394 downloads last week.

Scan summary: scanned Nov 5, 2026 at commit c440f65. Seen able to read environment and secrets, connect to the internet. Scan policy

aboutREADMEsecurityreviews

How to install Notion MCP Server

Built from the start command in the project's README: npx -y notion-mcp-server. Check the README for required keys or settings.

Claude Code · Terminal
claude mcp add notion-mcp-server -- npx -y notion-mcp-server
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ]
    }
  }
}
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ]
    }
  }
}
VS Code · Terminal
code --add-mcp '{"name":"notion-mcp-server","command":"npx","args":["-y","notion-mcp-server"]}'

What Notion MCP Server can touch

  • Run shell commandsNot seen in this scan
  • Run dynamic codeNot seen in this scan
  • Read or write filesNot seen in this scan
  • Read environment and secretsFound in the code by our scan
  • Control a web browserNot seen in this scan
  • Connect to databasesNot seen in this scan
  • Read or send messagesNot seen in this scan
  • Touch money or tradingNot seen in this scan
  • Connect to the internetContacted api.notion.com

"Not seen" means our checks did not find it, and the tool may still do it. Covers commit c440f65, Nov 5, 2026. See the scan policy.

Before you install Notion MCP Server

AgenticMart scanned Notion MCP Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What it can access

  • An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.
  • Based on its description and topics, it likely needs to read and write files on your machine.
  • Based on its description and topics, it likely needs to connect to a database.
  • Based on its description and topics, it likely needs to read or change your workspace data (docs, tickets, CRM).

Before you install

  1. Point it at one project folder, never your home directory.
  2. Give it a read-only database user unless it must write.
  3. Pin the version you reviewed instead of always installing the latest release.
  4. Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
  • Maintained by awkoy on GitHub, 179 stars and 41 forks. Popularity is not proof of safety.
  • Last code change: Oct 28, 2026.
  • Open-source license: MIT.
Read the scan reportWhat our scan checks

Tools Notion MCP Server exposes (3)

Listed by the server itself during our scan of commit c440f65.

  • notion_read

    Run one Notion read operation by name. Nothing is modified. Call: { operation, payload } — payload carries that operation's fields. Common: search_pages { query }, get_page { page_id }, get_page_markdown { page_id }, query_database { database_id, where? }, get_block_children { block_id }. Response

  • notion_write

    Run one Notion write operation by name. Archive, trash and delete operations remove content — confirm with the user before running them. Two ways to call: • Single: { operation: "set_page_title", payload: { page_id, title } } • Batch: { operation: "set_page_title", payload: { items: [{page_id,

  • notion_describe

    Return the JSON Schema and a working example for one operation, plus which tool runs it (notion_read or notion_write). Use this BEFORE calling the operation when the payload shape is non-trivial (query filters, structured block trees, database property definitions). For simple ops, just call it — er

Hosts it contacted while running

api.notion.com

Notion MCP Server is an open-source mcp server by awkoy, written mainly in TypeScript. Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless.

At a glance

Stars
179
Forks
41
Language
TypeScript
License
MIT
Created
Mar 2025
Last update
Oct 28, 2026
Type
MCP Server
Price
Free

Topics

ai-agentsanthropicchatgptclaudeclaude-codeclaude-desktopcodexcursorgemini-clillmmarkdownmcpmcp-servermcpbmodel-context-protocolnotionnotion-apinotion-mcptypescriptvscode

Questions about Notion MCP Server

What is Notion MCP Server?

Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless.

Who maintains Notion MCP Server?

Notion MCP Server is maintained by awkoy on GitHub (awkoy/notion-mcp-server). AgenticMart lists it from public repository data.

Is Notion MCP Server safe to use?

AgenticMart scanned Notion MCP Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What license does Notion MCP Server use?

It is published under the MIT license.

Notion MCP Server alternatives

View more →

Similar mcp servers in Productivity & Workflow, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

NameStarsLicenceLast updatedScan
Notion MCP Server (this page)
awkoy
179MITOct 28, 2026Scanned, no flagged issues
N8n MCP
czlonkowski
23kMITOct 27, 2026Scanned, no flagged issues
Trigger Dev
triggerdotdev
17kApache-2.0Oct 31, 2026Scanned, no flagged issues
Skill Seekers
yusufkaraaslan
15kMITSep 30, 2026Scanned, no flagged issues
Windows MCP
CursorTouch
11kMITNov 1, 2026Scanned, no flagged issues
Mobile MCP
mobile-next
10kApache-2.0Oct 30, 2026Scanned, no flagged issues