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

git clone https://github.com/Creo-DRB1008/prompt-logger-mcp.git
cd cursor-notion-mcp

2. Install Dependencies

pip install -r requirements.txt

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

{
  "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

# 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

./verify_cursor_mcp.sh

Full Test Suite

python3 test_mcp_notion.py

Manual MCP Protocol Test

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

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

# .env
NOTION_API_KEY=secret_YOUR_TOKEN
NOTION_DATABASE_ID=YOUR_DATABASE_ID

Then update mcp.json:

{
  "mcpServers": {
    "notion-chat-logger": {
      "command": "bash",
      "args": [
        "-c",
        "source .env && python3 /path/to/mcp_notion_server.py"
      ]
    }
  }
}

📚 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!