A VS Code extension that seamlessly integrates Cursor IDE with Notion for real-time documentation management. Create, update, and sync your project documentation directly from your IDE to Notion.
Select the workspace where you want to use the integration
Click "Submit" to create the integration
Copy your "Internal Integration Token"
2. Configure Extension
Open Command Palette in VS Code (Cmd/Ctrl + Shift + P)
Search for "Notion: Configure Settings"
Paste your Integration Token when prompted
The extension will verify your connection
3. Share Notion Pages
For each page you want to use with the extension:
Open the Notion page
Click "Share" in the top right
Under "Add connections", find your integration name
Click "Invite"
The page is now connected to the extension
Usage
Creating New Documentation
Open Command Palette
Select "Notion: Create New Documentation"
Enter a title for your documentation
Share the target Notion page with your integration
Paste the Notion page URL when prompted
Edit the .notion-docs file that opens
On your .cursorrules file, add the Documentation part to use .notion-docs file for documentation and to update it automatically after necessary changes (you can also tell the agent to update the documentation after certain changes)
Changes will automatically sync to Notion
Updating Documentation
The extension automatically watches the .notion-docs file and syncs changes to Notion in real-time.
Features
Real-time sync between Cursor and Notion
Markdown support
Automatic file watching
Project-specific configuration
Global API key management
Support for:
Headers (H1, H2, H3)
Lists (bullet and numbered)
Code blocks with language support
Bold text
Paragraphs
Important Notes
Each project can have its own Notion target page
The API key is stored globally and reused across projects
You must share each Notion page with the integration
Changes sync automatically when you save the .notion-docs file
Troubleshooting
Common Issues
"Failed to connect to Notion API"
Verify your API key is correct
Check your internet connection
"Cannot access page"
Make sure you've shared the page with your integration
Check if the page URL is correct
"Failed to update documentation"
Verify the page is still shared with the integration