🧠 HeadStarter MCP Server – Notion Automation
This MCP (Model Context Protocol) server gives AI-friendly access to Notion using natural language prompts. Built using Next.js, TypeScript, and @notionhq/client, this project was created by Krushali Chauhan as part of an internship at HeadStarter.
---
🚀 Add to Cursor (Optional)
To connect this server with Cursor or another AI tool, paste the following JSON into Cursor Settings → MCP → Add MCP Server:
json { "mcpServers": { "HeadStarter-MCP": { "url": "https://your-vercel-url.vercel.app/sse" } } } 🧩 Features ✅ Supported Actions Create Notion Pages via natural language
Extract and structure title and content
Real-time response via JSON
Coming soon: Google Docs & GitHub integration
🧰 Available Tools query-notion-page Creates a Notion page using extracted title and content.
Parameters: title (string): Title of the Notion page
content (string): Page content (plain text)
Example: json Copy code { "tool": "query-notion-page", "parameters": { "title": "To Do List", "content": "Gym, Sleep, Study" } } 🛠️ Setup 📁 Environment Variables (.env.local) env Copy code NOTION_SECRET=your-notion-secret NOTION_DATABASE_ID=your-database-id Create a Notion integration at https://www.notion.com/my-integrations
Share your Notion database with that integration
📦 Installation bash Copy code git clone https://github.com/your-username/headstarter-mcp-server.git cd headstarter-mcp-server npm install npm run dev 🧪 Test Example (via curl) bash Copy code curl -X POST http://localhost:3000/api/mcp \ -H "Content-Type: application/json" \ -d '{"prompt": "Create a Notion page titled To Do List and content Gym, Sleep, Study"}' You will receive a pageId in the response, confirming the page was created in Notion.
⚙️ Technical Stack Layer Tech Used Frontend Next.js + TypeScript Backend API Route + Notion SDK Prompt Logic Basic parsing Hosting Vercel (recommended)
👩💻 Author Krushali Chauhan HeadStarter Intern | Sheridan College 🇨🇦
