Stop Organizing, Start Learning: How I built an AI Study Buddy using Notion MCP

This is a submission for the Notion MCP Challenge

What I Built

Study Buddy is an intelligent orchestration layer that transforms a static Notion workspace into an active learning partner.

Managing a heavy study load often involves more "organizing" than actual "learning." Study Buddy solves this by connecting powerful LLMs (Google Gemini & Vultr Inference models) to your Notion pages via the Model Context Protocol (MCP). It acts as a proactive agent capable of:

• Synthesizing Knowledge: Answering questions based directly on your existing notes.
• Active Content Generation: Automatically creating structured study guides and active-recall quizzes from scratch.
• Multi-Channel Interaction: Accessible via a high-performance CLI for deep work or a private Telegram Bot for on-the-go learning.
• Enterprise-Grade Security: A custom implementation of OAuth 2.0 + PKCE with Dynamic Client Registration ensures your data remains yours.

Video Demo

Show us the code

GitHub Repository: Study Buddy MCP Client

How I Used Notion MCP

I utilized the Notion MCP Server as the standardized "nervous system" of the project. Instead of hardcoding API endpoints, I built a dynamic Orchestration Loop:

1. Reasoning: Using Google Gemini, the system interprets user intent (e.g., "Summarize my last lecture").
2. Tool Discovery: The client queries the MCP server to discover available capabilities (searching pages, creating content, appending blocks).
3. Autonomous Execution: The model emits tool_calls in strict JSON. My client executes these against the MCP server, feeds the results back to the LLM, and iterates until the study task is complete.
4. Resilient Auth: I implemented a robust OAuth 2.0 + PKCE flow. By using MCP, the client can discover resource metadata and handle token refreshes automatically, providing a seamless "plug-and-play" experience for any Notion user.

By abstracting Notion’s complexity into a 'Zero-UI' experience, Study Buddy handles the friction of database management and content structuring via simple chat, allowing students to spend less time 'organizing' and more time mastering their material.