mcpField
M
MCP Calendar

MCP Calendar

Local
github.com/tobedoitProductivity2Updated 36w ago
Repository

About MCP Calendar

A Python MCP server for creating and managing Google Calendar events, aimed at Claude desktop app users. It uses OAuth2 authentication and supports creating, editing, and viewing events.

Key features

  1. 01Create calendar events
  2. 02Edit and view events
  3. 03OAuth2 authentication
  4. 04Claude desktop app configuration

Use cases

  1. 01Adding a team meeting to Calendar
  2. 02Scheduling a dated event
  3. 03Checking or editing an event

MCP support

The MCP server connects Claude desktop app to Google Calendar and exposes event creation, editing, and viewing capabilities.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gCalendar-mcp-python": {
      "command": "uvx",
      "args": [
        "mcp-calendar-python"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>"
      }
    }
  }
}
Run commanduvx mcp-calendar-python
Environment variables to set
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRETSecret
GOOGLE_REFRESH_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-calendar-python

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Calendar

PyPI license

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 라이선스 하에 배포됩니다.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.