SystemPrompt NotionCAUTION
This an Model Context Protocol (MCP) server that integrates Notion into your AI workflows. This server enables seamless access to Notion through MCP, allowing AI agents to interact with pages, databases, and comments.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://www.npmjs.com/package/systemprompt-mcp-notion) [](https://coveralls.io/github/Ejb503/systemprompt-mcp-notion?branch=main) [](https://twitter.com/tyingshoelaces_) [](https://discord.com/invite/wkAbSuPWpr) [](https://smithery.ai/server/systemprompt-mcp-notion)
SystemPrompt MCP Notion Server
A high-performance Model Context Protocol (MCP) server that seamlessly integrates Notion into your AI workflows. This server enables AI agents to interact with Notion pages and databases through a standardized protocol. This server supports and requires MCP Sampling, which is required to the MCP to create and update Notion pages.
A compatible MCP client is available here.
Server Capabilities
const serverCapabilities: { capabilities: ServerCapabilities } = {
capabilities: {
resources: {
listChanged: true,
},
tools: {},
prompts: {
listChanged: true,
},
sampling: {},
},
};Key Features
- 📝 Comprehensive Content Management
- Create and update pages with rich text formatting
- Search across your Notion workspace
- 🛠 Developer-Friendly
- Extensive test coverage with Jest
- TypeScript support
- Comprehensive error handling
-
8bd57a56b28aOBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add systemprompt-mcp-notion --env NOTION_API_KEY=${NOTION_API_KEY} --env SYSTEMPROMPT_API_KEY=${SYSTEMPROMPT_API_KEY} -- npx -y [email protected]{
"mcpServers": {
"systemprompt-mcp-notion": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"NOTION_API_KEY": "${NOTION_API_KEY}",
"SYSTEMPROMPT_API_KEY": "${SYSTEMPROMPT_API_KEY}"
}
}
}
}Exposed tools (23)
19 read · 3 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
contact | read | The contact information |
databaseId | write | The ID of the database to create the page in |
formatted_contact | read | The formatted contact information |
items | read | List of todo items |
message | read | The user |
organized_todos | read | The organized todo list |
pageId | write | The ID of the page to edit |
person | read | Person |
priority | read | Priority level for the items |
response | read | The assistant |
systemprompt_create_notion_page | write | Creates a rich, comprehensive Notion page that expands upon basic user inputs. Takes simple instructions and content, then generates a detailed, well-structured page with appropriate sections, formatting, and supplementary content. |
systemprompt_delete_notion_page | destructive | Permanently deletes a specified Notion page and all its contents. This action cannot be undone, so use with caution. |
systemprompt_get_notion_page | read | Retrieves comprehensive details of a specific Notion page, including its content, properties, and metadata. Returns the complete page structure and all nested content blocks. |
systemprompt_list_notion_databases | read | Lists all accessible Notion databases in your workspace, sorted by last edited time. Returns key metadata including database title, schema, and last edited timestamp. |
systemprompt_list_notion_pages | read | Lists all accessible Notion pages in your workspace, sorted by last edited time. Returns key metadata including title, URL, and last edited timestamp. |
systemprompt_search_notion_pages | read | Performs a full-text search across all accessible Notion pages using the provided query. Searches through titles, content, and metadata to find relevant matches. |
systemprompt_search_notion_pages_by_title | read | Searches specifically for Notion pages with titles matching the provided query. Useful for finding exact or similar title matches when you know the page name. |
tags | read | Contact tags |
test_input | read | Test input description |
test_output | read | Test output description |
test_tool | read | Test tool |
todos | read | The user |
userInstructions | read | Basic instructions or outline for the page content that will be expanded into a comprehensive structure |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (10)
.gitkeep
systemprompt_delete_notion_page
.coveralls.yml
} from "../../types/index.js";
import { SystemPromptService } from "../../services/systemprompt-service.js";import * as serverModule from "../../index.js";
jest.mock("../../services/systemprompt-service.js");jest.mock("../../index.js", () => ({const baseUrl = "http://127.0.0.1/v1";
@modelcontextprotocol/sdk, @notionhq/client, ajv, dotenv, @babel/preset-env, @types/dotenv, @types/jest, @types/json-schema
Gates applied: no_behavioural_pass.
8bd57a56b28afull audit observations/trust-audit/mcp-server/ejb503__systemprompt-notion.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 8bd57a56b28a | CAUTION | B | 89 | first audit |
Questions
What is the SystemPrompt Notion MCP server?
This an Model Context Protocol (MCP) server that integrates Notion into your AI workflows. This server enables seamless access to Notion through MCP, allowing AI agents to interact with pages, databases, and comments.
What tools does SystemPrompt Notion expose?
23 in total: 19 read-only, 3 that write, and 1 that can delete or overwrite (systemprompt_delete_notion_page). Every one is listed on this page with its risk.
Is SystemPrompt Notion safe to connect to an agent?
With care. The audit graded it B (89/100) and found 10 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does SystemPrompt Notion need?
It reads NOTION_API_KEY and SYSTEMPROMPT_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does SystemPrompt Notion run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as systemprompt-mcp-notion at 1.0.7.
How current is this page?
The grade is for one exact copy of the source (8bd57a56b28a), read on 2026-10-08. The repository is watched and re-audited when it changes.