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

2. Install Dependencies

3. Set Up Notion

Create a Notion Integration

1. Go to Notion 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):

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

You should see:

💡 Usage

In Cursor Chat

After having a conversation with Cursor AI, simply say:

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:

🧪 Testing

Quick Verification

Full Test Suite

Manual MCP Protocol Test

📁 Project Structure

🔧 Configuration

Environment Variables

Notion Database Schema

Your Notion database must have these properties:

🐛 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

🔐 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:

Then update mcp.json:

📚 Documentation

• Setup Guide - Detailed setup instructions

• Architecture - Technical architecture and design

• MCP Specification - Official MCP docs

• Notion API - 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 file for details.

🙏 Acknowledgments

• Model Context Protocol - For the MCP specification

• Cursor - For the amazing AI-powered IDE

• Notion - For the powerful API and database

📞 Support

• Issues: GitHub Issues

• Discussions: GitHub 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!