Notion Bridge - Backend Access
SSH-like backend access to your Notion workspace from Visual Studio Code.
✨ Features
- 🌳 Sidebar Browser - Browse all your Notion workspaces and pages
- 📝 Dual Edit Modes - Edit as Markdown or raw JSON backend structure
- 💾 Direct Save - Ctrl+S saves directly to Notion (no export/import)
- 👁️ View Toggle - Switch between Code / Markdown / Both views
- 🔒 Secure Storage - Token stored in VSCode secrets (never in settings)
- 🏷️ Smart Tabs - Proper page titles, reuses tabs (no duplicates)
🚀 Quick Start
1. Install Extension
Install from VSCode Marketplace or download .vsix file
2. Get Your Notion Token
In Chrome/Edge:
- Go to notion.so (logged in)
- Press F12 (Developer Tools)
- Application tab → Cookies → https://www.notion.so
- Find token_v2 row
- Copy the Value (starts with v03:)
Faster: Use "EditThisCookie" browser extension
3. Authenticate
- Press Ctrl+Shift+P
- Run: Notion: Set Authentication Token
- Paste token → Done!
📖 Usage
Browse Pages
- Open Explorer sidebar
- Expand Notion Pages
- Click workspace → see pages
- Click page → opens in editor
View Modes
Click status bar button (bottom-right) to toggle:
- Code - Raw Notion JSON (backend structure)
- Markdown - Human-readable format
- Both - Side-by-side comparison
Edit & Save
- Edit page content
- Press Ctrl+S to save
- Markdown view: instant save
- JSON view: confirmation prompt (you're editing backend)
🔐 Security
- Token stored in VSCode's secure credential storage
- Never transmitted except to Notion's official API
- Local-only extension (no external servers)
⚙️ Commands
- Notion: Set Authentication Token - Configure access
- Notion: Test Connection - Verify authentication
- Notion: Refresh Explorer - Reload workspace list
- Notion: Change View Mode - Toggle display mode
- Notion: Load Page by ID - Open specific page
🛠️ Technical Details
Uses Notion's internal API:
- /api/v3/getSpaces - Load workspaces
- /api/v3/loadUserContent - Fetch pages
- /api/v3/loadPageChunk - Get page content
- /api/v3/saveTransactions - Save changes
Authentication: token_v2 cookie (same as desktop client)
❓ FAQ
Q: Is this official?
A: No, this uses Notion's internal API (same as their desktop app). Not affiliated with Notion.
Q: Will my token expire?
A: Yes, tokens expire periodically. Just re-run "Set Authentication Token" when needed.
Q: Can I break my workspace?
A: JSON editing has confirmation. Markdown editing is safe. But always backup important data.
Q: Does this work offline?
A: No, requires internet connection to Notion's API.
📝 License
MIT License - See LICENSE file
🙏 Credits
Built by Ravix DeWolf
⚠️ Disclaimer: This extension uses Notion's internal API. Use at your own risk. Not affiliated with or endorsed by Notion Labs, Inc.
