README.md•8.46 kB
# Cursor Notion MCP - Chat Logger
A Model Context Protocol (MCP) server that logs your Cursor AI chat interactions to Notion for analysis, documentation, and knowledge management.
## 🌟 Features
- ✅ **Automatic Chat Logging**: Log Cursor AI conversations to Notion with a single command
- ✅ **MCP Protocol**: Implements the official Model Context Protocol specification
- ✅ **Easy Setup**: Simple configuration via environment variables
- ✅ **Rich Context**: Captures prompt, response, user, context, and timestamp
- ✅ **Notion Integration**: Stores data in a structured Notion database
- ✅ **Privacy First**: Self-hosted, no third-party services
## 📋 Prerequisites
- Python 3.7 or higher
- Cursor IDE (with MCP support)
- Notion account with API access
- `requests` library (`pip install requests`)
## 🚀 Quick Start
### 1. Clone the Repository
```bash
git clone https://github.com/Creo-DRB1008/prompt-logger-mcp.git
cd cursor-notion-mcp
```
### 2. Install Dependencies
```bash
pip install -r requirements.txt
```
### 3. Set Up Notion
#### Create a Notion Integration
1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
2. Click "New integration"
3. Name it "Cursor Chat Logger"
4. Copy the **Internal Integration Token** (starts with `secret_`)
#### Create a Notion Database
1. Create a new database in Notion
2. Add these properties:
- **Prompt** (Title) - The user's question
- **Response** (Text) - The AI's response
- **User** (Text) - User identifier
- **Context** (Text) - File/function context
- **Timestamp** (Date) - When it happened
3. Share the database with your integration:
- Click "Share" on the database
- Invite your integration
4. Get the **Database ID** from the URL:
```
https://notion.so/YOUR_WORKSPACE/DATABASE_ID?v=...
^^^^^^^^^^^^
```
### 4. Configure Cursor
Edit `~/.cursor/mcp.json` (create if it doesn't exist):
```json
{
"mcpServers": {
"notion-chat-logger": {
"command": "python3",
"args": [
"/ABSOLUTE/PATH/TO/cursor-notion-mcp/mcp_notion_server.py"
],
"env": {
"NOTION_API_KEY": "secret_YOUR_NOTION_INTEGRATION_TOKEN",
"NOTION_DATABASE_ID": "YOUR_DATABASE_ID"
}
}
}
}
```
**Important**: Replace:
- `/ABSOLUTE/PATH/TO/` with the actual path to this repository
- `secret_YOUR_NOTION_INTEGRATION_TOKEN` with your Notion integration token
- `YOUR_DATABASE_ID` with your Notion database ID
### 5. Restart Cursor
Quit Cursor completely (⌘Q on Mac, Alt+F4 on Windows/Linux) and reopen it.
### 6. Verify Installation
```bash
# Run the test script
python3 test_mcp_notion.py
```
You should see:
```
✅ Initialize response
✅ Found 1 tool(s)
✅ Successfully stored to Notion!
```
## 💡 Usage
### In Cursor Chat
After having a conversation with Cursor AI, simply say:
```
Log this conversation to Notion
```
Or use the tool picker:
1. Type `@` in the chat
2. Select `store_chat_log`
3. Fill in the details (or let the AI do it)
### Manual Tool Call
You can also invoke the tool explicitly:
```
@store_chat_log
Prompt: "How do I implement OAuth?"
Response: "Here's how to implement OAuth..."
User: "your.email@example.com"
Context: "auth.py"
```
## 🧪 Testing
### Quick Verification
```bash
./verify_cursor_mcp.sh
```
### Full Test Suite
```bash
python3 test_mcp_notion.py
```
### Manual MCP Protocol Test
```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | python3 mcp_notion_server.py
```
## 📁 Project Structure
```
cursor-notion-mcp/
├── mcp_notion_server.py # Main MCP server
├── test_mcp_notion.py # Test suite
├── verify_cursor_mcp.sh # Quick verification script
├── requirements.txt # Python dependencies
├── README.md # This file
├── SETUP.md # Detailed setup guide
├── ARCHITECTURE.md # Technical architecture
└── LICENSE # MIT License
```
## 🔧 Configuration
### Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `NOTION_API_KEY` | Yes | Your Notion integration token |
| `NOTION_DATABASE_ID` | Yes | Your Notion database ID |
| `NOTION_VERSION` | No | Notion API version (default: 2022-06-28) |
### Notion Database Schema
Your Notion database must have these properties:
| Property | Type | Description |
|----------|------|-------------|
| Prompt | Title | The user's question/prompt |
| Response | Text | The assistant's response |
| User | Text | User identifier (email) |
| Context | Text | File path, function name, etc. |
| Timestamp | Date | When the interaction occurred |
## 🐛 Troubleshooting
### Server Not Showing in Cursor
1. Check that `~/.cursor/mcp.json` is valid JSON
2. Verify the absolute path to `mcp_notion_server.py` is correct
3. Restart Cursor completely (quit and reopen)
4. Check Cursor logs: `~/Library/Logs/Cursor/` (Mac) or `%APPDATA%\Cursor\logs\` (Windows)
### Tool Not Appearing
1. Verify the server is listed in Cursor Settings → Features → MCP
2. Try typing the full tool name: `@store_chat_log`
3. Check Developer Tools (Help → Toggle Developer Tools) for errors
### Notion API Errors
1. Verify your `NOTION_API_KEY` is correct (starts with `secret_`)
2. Verify your `NOTION_DATABASE_ID` is correct (32 characters, hex)
3. Ensure the integration has access to the database (Share → Invite integration)
4. Check that all required properties exist in the database
### Python Errors
```bash
# Check Python version
python3 --version # Should be 3.7+
# Install dependencies
pip3 install -r requirements.txt
# Test the server directly
python3 mcp_notion_server.py
# Then type: {"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
```
## 🔐 Security
**⚠️ Important Security Notes:**
1. **Never commit your Notion API key** to version control
2. **Use environment variables** for sensitive data
3. **Restrict integration permissions** in Notion to only the databases you need
4. **Review logged data** regularly to ensure no sensitive information is stored
5. **Consider encrypting** sensitive fields before logging
### Recommended: Use `.env` File
Instead of hardcoding credentials in `mcp.json`, use a `.env` file:
```bash
# .env
NOTION_API_KEY=secret_YOUR_TOKEN
NOTION_DATABASE_ID=YOUR_DATABASE_ID
```
Then update `mcp.json`:
```json
{
"mcpServers": {
"notion-chat-logger": {
"command": "bash",
"args": [
"-c",
"source .env && python3 /path/to/mcp_notion_server.py"
]
}
}
}
```
## 📚 Documentation
- [Setup Guide](SETUP.md) - Detailed setup instructions
- [Architecture](ARCHITECTURE.md) - Technical architecture and design
- [MCP Specification](https://spec.modelcontextprotocol.io/) - Official MCP docs
- [Notion API](https://developers.notion.com/) - Notion API documentation
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [Model Context Protocol](https://modelcontextprotocol.io/) - For the MCP specification
- [Cursor](https://cursor.sh/) - For the amazing AI-powered IDE
- [Notion](https://notion.so/) - For the powerful API and database
## 📞 Support
- **Issues**: [GitHub Issues](https://github.com/YOUR_USERNAME/cursor-notion-mcp/issues)
- **Discussions**: [GitHub Discussions](https://github.com/YOUR_USERNAME/cursor-notion-mcp/discussions)
## 🗺️ Roadmap
- [ ] Support for multiple Notion databases
- [ ] Filtering/redaction of sensitive data
- [ ] Export to other formats (CSV, JSON)
- [ ] Web dashboard for viewing logs
- [ ] Automatic tagging and categorization
- [ ] Search and analytics features
---
**Made with ❤️ for the Cursor community**
If you find this useful, please ⭐ star the repository!