https://github.com/tkc/notion-mcp
Notion MCP Server
https://github.com/tkc/notion-mcp
mcp mcp-server notion notion-api
Last synced: 2 months ago
JSON representation
Notion MCP Server
- Host: GitHub
- URL: https://github.com/tkc/notion-mcp
- Owner: tkc
- Created: 2025-03-20T10:26:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-20T10:36:59.000Z (about 1 year ago)
- Last Synced: 2025-03-20T11:34:18.144Z (about 1 year ago)
- Topics: mcp, mcp-server, notion, notion-api
- Language: TypeScript
- Homepage:
- Size: 75.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **notion-mcp** - Notion MCP Server (TypeScript-based) `typescript` `mcp` `mcp-server` `notion` `notion-api` `npm install tkc/notion-mcp` (🌐 Web Development)
README
# Claude Desktop Notion MCP Server
A filesystem Model Context Protocol (MCP) server implementation for Claude Desktop. This server provides filesystem capabilities to Claude, allowing it to read, write, and manipulate files on your system.
## Features
- List files with glob pattern matching
- Read file contents
- Write to files
- Edit files with diff output
- Delete files
- Secure path normalization to prevent directory traversal attacks
## Prerequisites
- [Bun](https://bun.sh) v1.2.5 or later
## Installation
Clone the repository and install dependencies:
```bash
git clone https://github.com/yourusername/claude-desktop-mcp.git
cd claude-desktop-mcp
bun install
```
## Usage
claude_desktop_config.json
```bash
{
"mcpServers": {
"notion": {
"command": "~/.bun/bin/bun",
"args": [
"run",
"/src/notion/index.ts",
"your_notion_integration_key_here"
]
}
}
}
```
If no base directory is provided, the current working directory will be used.
## Available Tools
The server exposes the following tools:
- `list_files`: Lists files matching a glob pattern
- `read_file`: Reads the content of a file
- `write_file`: Writes content to a file
- `edit_file`: Edits an existing file with the provided content and shows diff
- `delete_file`: Deletes a file
## Security
The server implements path normalization and validation to ensure that operations are restricted to the specified base directory, preventing directory traversal attacks.
## License
MIT
## Acknowledgments
- Based on the [Model Context Protocol](https://modelcontextprotocol.io/) specification
- Built with [Bun](https://bun.sh) JavaScript runtime