gCalendar-mcp-python

gCalendar-mcp-python

3.4

MCP Calendar is a tool for creating Google Calendar events using the Model Context Protocol server.

MCP Calendar

MCP(Model Context Protocol) ์„œ๋ฒ„๋ฅผ ์ด์šฉํ•œ Google Calendar ์ด๋ฒคํŠธ ์ƒ์„ฑ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

์„ค์น˜ ๋ฐฉ๋ฒ•

pip install mcp-calendar-python

๊ธฐ๋Šฅ

  • Claude ๋ฐ์Šคํฌํ†ฑ ์•ฑ์—์„œ MCP ์„œ๋ฒ„๋ฅผ ํ†ตํ•ด Google Calendar ์ด๋ฒคํŠธ๋ฅผ ์ƒ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
  • OAuth2๋ฅผ ํ†ตํ•œ ์•ˆ์ „ํ•œ Google Calendar API ์ธ์ฆ
  • ์ด๋ฒคํŠธ ์ƒ์„ฑ, ์ˆ˜์ •, ํ™•์ธ ๊ธฐ๋Šฅ ์ง€์›

์‹œ์ž‘ํ•˜๊ธฐ

ํ•„์ˆ˜ ์š”๊ตฌ์‚ฌํ•ญ

  • Python 3.10 ์ด์ƒ
  • Google Cloud Console์—์„œ ์ƒ์„ฑํ•œ OAuth 2.0 ํด๋ผ์ด์–ธํŠธ ID์™€ ์‹œํฌ๋ฆฟ
  • Claude ๋ฐ์Šคํฌํ†ฑ ์•ฑ

์„ค์ •๋ฐฉ๋ฒ•

  1. Google Cloud ์ฝ˜์†”์—์„œ ํ”„๋กœ์ ํŠธ ๋ฐ OAuth 2.0 ํด๋ผ์ด์–ธํŠธ ID ์ƒ์„ฑ:
  • Google Cloud Console์—์„œ ์ƒˆ ํ”„๋กœ์ ํŠธ ์ƒ์„ฑ
  • API ๋ฐ ์„œ๋น„์Šค > ์‚ฌ์šฉ์ž ์ธ์ฆ ์ •๋ณด์—์„œ OAuth 2.0 ํด๋ผ์ด์–ธํŠธ ID ์ƒ์„ฑ
  • Calendar API ํ™œ์„ฑํ™”
  1. ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •:
GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REFRESH_TOKEN="your_refresh_token"
  1. Claude ๋ฐ์Šคํฌํ†ฑ ์•ฑ์—์„œ ๋‹ค์Œ ์„ค์ • ์‚ฌ์šฉ:
{
  "mcp-calendar-python": {
    "command": "uvx",
    "args": [
      "mcp-calendar-python"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id", 
      "GOOGLE_CLIENT_SECRET": "your_client_secret", 
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
    }
  }
}

์‚ฌ์šฉ๋ฐฉ๋ฒ•

Claude์—๊ฒŒ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์š”์ฒญํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

  • "๋‚ด์ผ ์˜คํ›„ 2์‹œ์— ํŒ€ ๋ฏธํŒ… ์ผ์ •์„ ์ถ”๊ฐ€ํ•ด์ค˜"
  • "5์›” 15์ผ ์ ์‹ฌ์‹œ๊ฐ„์— ๋ฏธํŒ… ์ผ์ •์„ ์ถ”๊ฐ€ํ•ด์ค˜"

๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค ํ•˜์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.