cgantro/todo_mcp# ๐ Google Calendar Smart Manager (MCP) Turn Google Calendar into your intelligent assistant. This MCP server lets you manage schedules and notes seamlessly through AI conversations, keeping everything organized in one place. --- ## ๐ Core Guide ### 1. Unified Schedule & Notes Management * **Description Field as Notes** No separate note-taking app needed. All details you provide when creating an event (agenda, preparation notes, links, etc.) are stored directly in the **Google Calendar โDescriptionโ** field. * **Single Source of Truth** Everything lives in Google Calendar, fully synced across web and mobile. --- ### 2. Automatic Color-Based Categorization (3 Core Types) The AI analyzes each event and automatically assigns a calendar color based on its purpose. No tags in titlesโyour calendar stays clean and readable. | Category | Calendar Color | Use Case | | ------------------- | ------------------- | --------------------------------------- | | **Work** | ๐ต Blueberry (Blue) | Meetings, deadlines, project tasks | | **Personal** | ๐ข Basil (Green) | Hobbies, workouts, personal plans | | **Family / Events** | ๐ด Tomato (Red) | Weddings, family gatherings, ceremonies | --- ### 3. Smart Search & Alerts * **Flexible Queries** Retrieve todayโs events, the next 7 days, or up to 30 days at once. * **Urgent Email Alerts** If an event starts within the next 2 hours, a detailed notification (including notes) can be sent to a designated email address. * **Natural Deletion** Say things like *โCancel my afternoon schedule todayโ* or *โDelete the โGymโ event I added yesterdayโ* โ the server finds and removes the correct event. --- ## ๐ฌ AI Assistant Conversation Examples Once the MCP server is installed, use it with AI clients (e.g. Claude) like this: > **Create an Event** > โAdd a work meeting today at 3 PM. > In the notes, write โMeeting Room B, bring weekly report.โโ > *(Result: The event is saved in blue with notes included.)* > **Custom Search** > โShow me all family-related events scheduled for this week.โ > *(Result: Events are filtered using calendar color categorization.)* > **Urgent Alert** > โCheck for events starting within the next 2 hours and send me an urgent email alert.โ > *(Result: An email is sent with detailed event information.)* > **Help Request** > โHow do I use this server?โ > *(Result: The built-in helper tool explains all features and categories.)* --- ## ๐ Notes * **Initial Authorization** When you use the tools for the first time, a browser window will open for Google account authentication. After completing login once, future connections are automatic. # ๐ Google Calendar Smart Manager (MCP) ๊ตฌ๊ธ ์บ๋ฆฐ๋๋ฅผ ๋น์ ์ ๋๋ํ ๋น์๋ก ๋ง๋ค์ด์ฃผ๋ MCP ์๋ฒ์ ๋๋ค. ๋ณต์กํ ์ผ์ ๊ด๋ฆฌ์ ํฉ์ด์ง ๋ฉ๋ชจ๋ฅผ AI์ ๋ํํ๋ฉฐ ํ๊ณณ์์ ์ฒด๊ณ์ ์ผ๋ก ๊ด๋ฆฌํ์ธ์. --- ## ๐ ํต์ฌ ๊ฐ์ด๋ ### 1. ์ผ์ & ๋ฉ๋ชจ ํตํฉ ๊ด๋ฆฌ * **์ค๋ช (Description) ํ๋ ํ์ฉ**: ๋ณ๋์ ๋ฉ๋ชจ ์ฑ์ด ํ์ ์์ต๋๋ค. ์ผ์ ๋ฑ๋ก ์ ์ ๋ฌํ๋ ๋ชจ๋ ์ธ๋ถ ์ฌํญ(ํ์ ์๊ฑด, ์ค๋น๋ฌผ ๋ฑ)์ ๊ตฌ๊ธ ์บ๋ฆฐ๋์ **'์ค๋ช '** ์นธ์ ์ฆ์ ์ ์ฅ๋ฉ๋๋ค. * **ํตํฉ ์ ์ฅ์**: ๋ชจ๋ ๋ฐ์ดํฐ๊ฐ ๊ตฌ๊ธ ์บ๋ฆฐ๋ ํ๋์ ๋ชจ์ด๋ฏ๋ก ๋ชจ๋ฐ์ผ๊ณผ ์น ์ด๋์๋ ๋๊ธฐํ๋ ์ผ์ ์ ํ์ธํ ์ ์์ต๋๋ค. ### 2. ์์ ๊ธฐ๋ฐ ์๋ ๋ถ๋ฅ (3๋ ์นดํ ๊ณ ๋ฆฌ) AI๊ฐ ์ผ์ ์ ์ฑ๊ฒฉ์ ํ์ ํ์ฌ ์บ๋ฆฐ๋์ ์์์ ์๋์ผ๋ก ์ง์ ํฉ๋๋ค. ์ ๋ชฉ ์์ ๋ณ๋์ ํ๊ทธ๋ฅผ ๋ถ์ด์ง ์์ ์บ๋ฆฐ๋ ๋ทฐ๊ฐ ๋งค์ฐ ๊น๋ํฉ๋๋ค. | ์นดํ ๊ณ ๋ฆฌ | ์บ๋ฆฐ๋ ์์ | ์ฉ๋ | | :--- | :--- | :--- | | **์ ๋ฌด (Work)** | ๐ต ํ๋์ (Blueberry) | ํ์, ๋ง๊ฐ์ผ, ํ๋ก์ ํธ ์ ๋ฌด ๋ฑ | | **๊ฐ์ธ (Personal)** | ๐ข ์ฐ๋์ (Basil) | ์ทจ๋ฏธ, ์ด๋, ๊ฐ์ธ ์ฝ์, ํ ์ผ ๋ฑ | | **๊ฒฝ์กฐ์ฌ (Family)** | ๐ด ๋นจ๊ฐ์ (Tomato) | ๊ฒฐํผ์, ์ ์ฌ, ๊ฐ์กฑ ๋ชจ์ ๋ฑ ์ค์ ํ์ฌ | ### 3. ์ค๋งํธ ๊ฒ์ ๋ฐ ์๋ฆผ * **์ ์ฐํ ์กฐํ**: ์ค๋, ์ด๋ฒ ์ฃผ(7์ผ)๋ ๋ฌผ๋ก ์ต๋ 30์ผ์น ์ผ์ ์ ํ ๋ฒ์ ๋ถ๋ฌ์ต๋๋ค. * **๊ธด๊ธ ์ด๋ฉ์ผ ์๋ฆผ**: 2์๊ฐ ์ด๋ด์ ์์๋๋ ๊ธ๋ฐํ ์ผ์ ์ด ์๋ค๋ฉด, ์์ธ ๋ฉ๋ชจ๋ฅผ ํฌํจํ์ฌ ์ง์ ๋ ์ด๋ฉ์ผ๋ก ์ฆ์ ์๋ฆผ์ ๋ณด๋ ๋๋ค. * **๊ฐํธํ ์ญ์ **: "์ค๋ ์คํ ์ผ์ ์ทจ์๋์ด" ๋๋ "์ด์ ๋ฑ๋กํ 'ํฌ์ค์ฅ' ์ผ์ ์ญ์ ํด์ค"๋ผ๊ณ ํ๋ฉด ๊ด๋ จ ์ผ์ ์ ์ฐพ์ ์ ๋ฆฌํฉ๋๋ค. --- ## ๐ฌ AI ๋น์ ๋ํ ์์ ์ค์น๋ MCP ๋๊ตฌ๋ฅผ ํ์ฉํด AI(Claude ๋ฑ)์๊ฒ ๋ค์๊ณผ ๊ฐ์ด ์์ฒญํด ๋ณด์ธ์. > **์ผ์ ๋ฑ๋ก** > "์ค๋ ์คํ 3์์ ํ ๋ฏธํ ์ ๋ฌด๋ก ๋ฑ๋กํด์ค. ๋ฉ๋ชจ์๋ 'ํ์์ค B, ์ฃผ๊ฐ ๋ณด๊ณ ์ ์ง์ฐธ'์ด๋ผ๊ณ ์ ์ด์ค." > *(๊ฒฐ๊ณผ: ํ๋์์ผ๋ก ์ผ์ ๊ณผ ๋ฉ๋ชจ๊ฐ ํจ๊ป ์ ์ฅ๋ฉ๋๋ค.)* > **๋ง์ถค ์กฐํ** > "์ด๋ฒ ์ฃผ์ ์กํ ๊ฒฝ์กฐ์ฌ ์ผ์ ๋ค๋ง ์น ๋ชจ์์ ๋ณด์ฌ์ค." > *(๊ฒฐ๊ณผ: ์์ ์ฝ๋๋ฅผ ๋ถ์ํ์ฌ ๊ฒฝ์กฐ์ฌ ์นดํ ๊ณ ๋ฆฌ๋ง ํํฐ๋งํฉ๋๋ค.)* > **๊ธด๊ธ ์๋ฆผ** > "์ง๊ธ๋ถํฐ 2์๊ฐ ๋ด์ ์๋ ์ผ์ ์ ํ์ธํด์ ๋ด ๋ฉ์ผ๋ก ๊ธด๊ธ ์๋ ๋ณด๋ด์ค." > *(๊ฒฐ๊ณผ: 2์๊ฐ ๋ด ์ผ์ ์ ์ฒดํฌํ์ฌ ์์ธ ๋ด์ฉ๊ณผ ํจ๊ป ์ด๋ฉ์ผ์ ๋ฐ์กํฉ๋๋ค.)* > **๋์๋ง ์์ฒญ** > "์ด ์๋ฒ๋ ์ด๋ป๊ฒ ์ฐ๋ ๊ฑฐ์ผ?" > *(๊ฒฐ๊ณผ: ๋ด์ฅ๋ Helper ๋๊ตฌ๊ฐ ๋ชจ๋ ๊ธฐ๋ฅ๊ณผ ์นดํ ๊ณ ๋ฆฌ ์ฌ์ฉ๋ฒ์ ์๋ดํฉ๋๋ค.)* --- ## ๐ ์ฐธ๊ณ ์ฌํญ * **์ต์ด ์ธ์ฆ**: ์๋ฒ ์ฐ๊ฒฐ ํ ๋๊ตฌ๋ฅผ ์ฒ์ ์ฌ์ฉํ ๋, ๊ตฌ๊ธ ๊ณ์ ๋ก๊ทธ์ธ์ ์ํ ๋ธ๋ผ์ฐ์ ์ฐฝ์ด ํ ๋ฒ ์ด๋ฆฝ๋๋ค. ๋ก๊ทธ์ธ์ ์๋ฃํ๋ฉด ์ดํ์๋ ์๋์ผ๋ก ์ฐ๊ฒฐ๋ฉ๋๋ค.