MCP Servers
awkoy/notion-mcp-server
Notion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.
Our verdict
We have not reviewed awkoy/notion-mcp-server yet
No one at Enterprise DNA has checked this listing against its sources. The description comes from public listings gathered automatically. Any fact below shows where it came from and when it was last checked.
From the listing
About awkoy/notion-mcp-server
A TypeScript server that exposes Notion's pages, databases, blocks, comments, and files through the Model Context Protocol. It lets Claude, Cursor, ChatGPT and Claude Desktop read and write to Notion workspaces via a standardized interface.
Best for
Developers who want to connect AI coding assistants or agents to their Notion workspace for automated document management and data retrieval.
Use cases
- Create and update Notion pages from AI agent conversations
- Query Notion databases and retrieve structured data for analysis
- Manage comments and blocks within Notion documents programmatically
Notes
160 stars on GitHub. Last updated 2026-07-03. Licensed MIT.
Pros
- Works with multiple popular AI assistants and IDEs out of the box
- Open source and built on the established Model Context Protocol
- Covers core Notion objects (pages, databases, blocks, comments, files)
Cons
- Requires a Notion integration token with proper permissions
- Limited to capabilities exposed by the Notion API (no offline or real-time sync)
- Dependent on the client's MCP implementation for stability and features
Key facts
What we have checked
- Days since the last commit
- 1
- GitHub forks
- 42
- GitHub stars
- 180
- Days to a first reply on issues
- 2.4
- Open issues
- 0
- Releases in the last 90 days
- 10
Each value shows when we last confirmed it and where it came from. Values we have not confirmed are left out, never guessed.
How to use
How to set it up
As the listing publishes it. We have not run this install.
Install
npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_hereTools exposed
NOTION_TOKENNOTION_PAGE_IDNOTION_RATE_LIMITNOTION_READ_ONLYNOTION_CONFIRM_DESTRUCTIVENOTION_UPLOAD_ROOTNOTION_FILE_URLSNOTION_DAILY_LOG_PAGE_IDMCP_TRANSPORTMCP_AUTH_TOKENMCP_ALLOWED_HOSTSMCP_ALLOWED_ORIGINS
Clients the listing names (not checked here)
Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, VS Code, ChatGPT
Install
Add awkoy/notion-mcp-server to your client
Our lab has not run this server yet. "Config checked" on a client means the recipe matches that client's documented config format; it does not mean we ran it.
Claude Code
Config checkedRun in your terminal (runs on your computer)
claude mcp add --env NOTION_TOKEN=YOUR_NOTION_TOKEN --transport stdio awkoy-notion-mcp-server -- npx -y notion-mcp-server@3.2.1Needs NOTION_TOKEN: replace each YOUR_ value with your own.
Claude Desktop
Config checkedAdd to claude_desktop_config.json (runs on your computer)
{
"mcpServers": {
"awkoy-notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server@3.2.1"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Needs NOTION_TOKEN: replace each YOUR_ value with your own.
Cursor
Config checkedAdd to .cursor/mcp.json (runs on your computer)
{
"mcpServers": {
"awkoy-notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server@3.2.1"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}Needs NOTION_TOKEN: replace each YOUR_ value with your own.
VS Code
Config checkedAdd to .vscode/mcp.json (runs on your computer)
{
"inputs": [
{
"type": "promptString",
"id": "notion-token",
"description": "Notion Personal Access Token (ntn_...) or Internal Integration Secret. Create at https://app.notion.com/developers/tokens",
"password": true
}
],
"servers": {
"awkoy-notion-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"notion-mcp-server@3.2.1"
],
"env": {
"NOTION_TOKEN": "${input:notion-token}"
}
}
}
}Needs NOTION_TOKEN: replace each YOUR_ value with your own.
Codex
Config checkedAdd to ~/.codex/config.toml (runs on your computer)
[mcp_servers.awkoy-notion-mcp-server]
command = "npx"
args = ["-y", "notion-mcp-server@3.2.1"]
env_vars = ["NOTION_TOKEN"]Needs NOTION_TOKEN: replace each YOUR_ value with your own.
- ChatGPT: ChatGPT connects only to remote servers that need no API key.
Recipes come from the server's entry in the official MCP registry. Check the package name before you run it, and keep keys out of shared files.
Works with
What awkoy/notion-mcp-server connects to
1 product and 5 clients, each with how we know and when we checked.
| Works with | Type | How we know | Checked |
|---|---|---|---|
| Notion | Product | Its name pairs the product with MCPname "notion-mcp-server" | GitHub |
| Claude Code | Client | Install recipe matches the client's documented formatRuns locally, version 3.2.1Config checked | Claude Code docs |
| Claude Desktop | Client | Install recipe matches the client's documented formatRuns locally, version 3.2.1Config checked | Claude Desktop docs |
| Cursor | Client | Install recipe matches the client's documented formatRuns locally, version 3.2.1Config checked | Cursor docs |
| VS Code | Client | Install recipe matches the client's documented formatRuns locally, version 3.2.1Config checked | VS Code docs |
| Codex | Client | Install recipe matches the client's documented formatRuns locally, version 3.2.1Config checked | Codex docs |
Stars and usage
How awkoy/notion-mcp-server is growing
179 to 180
Health and security
Is awkoy/notion-mcp-server looked after, and what do its setup files show
Health score
65 out of 100
| Part | Points | What we saw |
|---|---|---|
| Recent activity | 30 of 30 | Last push 1 days ago |
| Releases | 15 of 15 | 10 releases in 90 days |
| Issue replies | 20 of 20 | First reply in 2.4 days (median) |
| Maintainer | 0 of 15 | Owned by a single user |
| Official source | 0 of 20 | Community server |
Alternatives
Alternatives to awkoy/notion-mcp-server
| Record | Type | How we know | Checked |
|---|---|---|---|
| AcornReplyAlternative to this | MCP server | Matched from the listing text | |
| sooperset/mcp-atlassianThis is an alternative to it | MCP server | Named in the listing | Not dated |
Compare
Compare awkoy/notion-mcp-server side by side
Sources
Where this comes from
- GitHubRegistry
A source shows what was published when we checked it. It does not certify security, performance or a working installation. Read our method.
Changelog
What changed
No changes recorded yet. Releases, price changes and deprecations appear here, with their dates, once we track them for this record.
Open-source & AI alternatives
Swap-in tools that solve the same job. Weigh the trade-offs before you commit.
Pairs with
Other entries in the index that connect to this one. Click through to see the chain.
Get the free Developer’s Field Guide
A 27-page field guide to the AI coding workflow with Claude. Claude Code, MCP servers, the prompt patterns that work, and what to delegate. Free.
Enter your work email. We send it straight over, plus a few short notes worth knowing. Unsubscribe any time.