seonglae_mcp_notion
by seonglaeNotion Workspace MCP Server
Overview
The Notion Workspace MCP Server is a Model Context Protocol (MCP) server designed to manage and interact with Notion-based notes. This TypeScript-based server allows users to browse their entire Notion workspace, not just a single database, by converting Notion pages into text/markdown mimeType notes. It eliminates the need for a token by using a single ROOT_PAGE variable for configuration.
Features
Resources
- Access Notes: List and retrieve Notion pages as
note://URIs with UUID slugs. - Metadata: Each resource includes a title, description, and content in Markdown format.
- Mime Types: Content is accessible in
text/markdownformat.
Tools
- Search Notes: Use the
search_notestool to search for Notion pages using a query string. - Input: Query text to filter relevant pages.
- Output: Markdown content of matching notes.
Prompts
- Summarize Notes: Generate summaries for individual Notion pages.
- Available Prompts:
summarize_note: Summarize a specific note by URI.suggest_refactor: Propose structural improvements.suggest_fix: Identify potential fixes for note content.suggest_enhance: Recommend enhancements to improve the note.
- Input: Notion page URI.
- Output: Structured messages for summarization and enhancement.
Development
Setup
Install dependencies:
pnpm install
Build the project:
pnpm build
For development with auto-rebuild:
pnpm watch
Configuration
To configure the server with Notion:
- Set environment variables:
- ROOT_PAGE: The root page ID of your Notion workspace.
Installation for Claude Desktop
To use this server with Claude Desktop, add the configuration:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
Example configuration:
{
"mcpServers": {
"notion-texonom": {
"command": "node",
"args": ["/path/to/mcp/build/index.js"],
"env": {
"ROOT_PAGE": "$SOME_UUID"
}
}
}
}
Debugging
For troubleshooting and debugging the MCP server, use the MCP Inspector. To start the Inspector, run:
pnpm inspector
The Inspector provides a browser-based interface for inspecting stdio-based server communication.
Key Technologies
- Notion Integration: Powered by
@texonom/nclientand@texonom/cli. - MCP SDK: Implements
@modelcontextprotocol/sdkfor server operations.
Remote Deployment
The server now uses SSEServerTransport for remote communication, enabling shared usage of the server. Ensure that the necessary dependencies are installed and the server is configured correctly for remote deployment.
Usage Instructions
To run the server with SSEServerTransport, use the following command:
npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"
Make sure to replace /some/folder with the appropriate path to your folder.
About
Global Notion workspace-accessible MCP server for all Notion pages within the workspace.
Topics
- mcp
- notion
- notion-api
- prompt-engineering
- anthropic
- model-context-protocol
- context-protocol
- ai-protocol
Resources
Stars
Watchers
Forks
Contributors
Languages
- TypeScript 70.7%
- JavaScript 29.3%
Invite Gmail Contacts
