https://github.com/ejb503/systemprompt-mcp-notion
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.
https://github.com/ejb503/systemprompt-mcp-notion
ai mcp mcp-server systemprompt
Last synced: 7 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/ejb503/systemprompt-mcp-notion
- Owner: Ejb503
- License: other
- Created: 2025-01-15T13:09:08.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-18T17:01:15.000Z (8 months ago)
- Last Synced: 2025-03-19T18:05:51.940Z (7 months ago)
- Topics: ai, mcp, mcp-server, systemprompt
- Language: TypeScript
- Homepage: https://systemprompt.io
- Size: 302 KB
- Stars: 13
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# systemprompt-mcp-notion
[](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)
[Website](https://systemprompt.io) | [Documentation](https://systemprompt.io/documentation)
# 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](https://github.com/Ejb503/multimodal-mcp-client).
## Server Capabilities
```typescript
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
- Detailed logging and debugging tools
## Prerequisites
Before using this server, you'll need:
1. **Systemprompt API Key** (Free)
- Sign up at [systemprompt.io/console](https://systemprompt.io/console)
- Create a new API key in your dashboard
2. **Notion Account and Workspace**
- Active Notion account
- Workspace with content you want to access
3. **Notion Integration**
- Create at [notion.so/my-integrations](https://www.notion.so/my-integrations)
- Required capabilities:
- Read/Update/Insert content
- Database management
- Search functionality
4. **MCP-Compatible Client**
- [Systemprompt MCP Client](https://github.com/Ejb503/multimodal-mcp-client)
- Any other MCP-compatible client
## Quick Start
1. **Installation**
### Installing via Smithery
To install systemprompt-mcp-notion for Claude Desktop automatically via [Smithery](https://smithery.ai/server/systemprompt-mcp-notion):
```bash
npx -y @smithery/cli install systemprompt-mcp-notion --client claude
```
```bash
npm install systemprompt-mcp-notion
```
2. **Configuration**
Create a `.env` file:
```env
SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
NOTION_API_KEY=your_notion_integration_token
```
3. **MCP Configuration**
Add the following to your MCP configuration JSON:
```json
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["systemprompt-mcp-notion"],
"env": {
"SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
"NOTION_API_KEY": "your_notion_integration_token"
}
}
}
}
```
Alternatively, if you've installed the package locally:
```json
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["./node_modules/systemprompt-mcp-notion/build/index.js"],
"env": {
"SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
"NOTION_API_KEY": "your_notion_integration_token"
}
}
}
}
```
## Development
### Setup
1. Clone the repository:
```bash
git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
cd systemprompt-mcp-notion
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment:
```bash
cp .env.example .env
# Edit .env with your API keys
```
### Testing
We maintain high test coverage using Jest:
```bash
# Run all tests
npm test
# Watch mode for development
npm run test:watch
# Generate coverage report
npm run test:coverage
# Test Notion API connection
npm run test:notion
```