open-index/open-npm huggingface dataset:
npm package: @t.miyano/mcp-google-calendar
Description: MCP server for managing Google Calendar alarms (reminders)
Latest version: 0.1.3

# @t.miyano/mcp-google-calendar

Google Calendarのアラーム（リマインダー）を管理するMCP (Model Context Protocol) サーバーです。AIエディタ（Cursor等）からGoogleカレンダーに接続し、スケジュールのアラームを操作できます。

## 機能

このMCPサーバーは、Google Calendar APIと連携して以下の機能を提供します：

- **アラーム一覧の取得**: 指定期間内のアラーム（リマインダー付きイベント）を取得
- **アラームの作成**: 新しいアラームをGoogleカレンダーに登録
- **アラームの更新**: 既存のアラーム情報を変更
- **アラームの削除**: アラームを削除

## インストール

```bash
npm install -g @t.miyano/mcp-google-calendar
```

## セットアップ

### 1. Google Calendar APIの認証情報を取得

1. [Google Cloud Console](https://console.cloud.google.com/)でプロジェクトを作成
2. Google Calendar APIを有効化
3. OAuth 2.0認証情報を作成（デスクトップアプリケーション用）
4. 認証情報をJSON形式でダウンロード

### 2. 認証情報ファイルの配置

認証情報ファイルを以下の場所に配置してください：

```bash
# macOS/Linux
~/.config/mcp-google-calendar/credentials.json

# Windows
%APPDATA%\mcp-google-calendar\credentials.json
```

認証情報ファイルの形式：

```json
{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "your-project-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost"]
  }
}
```

### 3. 初回認証

MCPサーバーを初めて起動すると、ブラウザが自動的に開き、Googleアカウントでの認証を求められます。認証が完了すると、認証トークンが自動的に保存され、次回以降は自動的にログインされます。

## Cursorでの設定

### STDIOモード（推奨）

CursorのMCP設定ファイル（`~/.cursor/mcp.json`）に以下を追加してください：

```json
{
  "mcpServers": {
    "google-calendar": {
      "command": "mcp-google-calendar",
      "args": ["--transport", "stdio"]
    }
  }
}
```

### Node.jsバージョン管理ツール（mise等）を使用する場合

```json
{
  "mcpServers": {
    "google-calendar": {
      "command": "mise",
      "args": [
        "exec",
        "--",
        "mcp-google-calendar",
        "--transport",
        "stdio"
      ]
    }
  }
}
```

### 設定後の確認

1. Cursorを再起動
2. Cursorの設定画面でMCPサーバーの接続状態を確認
3. エラーが表示される場合は、ログを確認してください

## 使用方法

設定が完了すると、CursorのAIアシスタントから以下のようにGoogleカレンダーのアラームを操作できます：

### アラーム一覧の取得

「来週のアラームを教えて」などの指示で、指定期間内のアラーム一覧を取得できます。

### アラームの作成

「明日の10時に会議のアラームを設定して」などの指示で、新しいアラームを作成できます。

### アラームの更新・削除

既存のアラーム情報を変更したり、削除したりすることも可能です。

## トラブルシューティング

### 認証エラーが発生する

- `credentials.json`ファイルが正しい場所に配置されているか確認してください
- OAuth 2.0認証情報が正しく記入されているか確認してください
- リダイレクトURIが`http://localhost`に設定されているか確認してください

### Cursorで接続できない

- `mcp.json`の設定が正しいか確認してください
- Cursorを完全に再起動してください
- コマンド`mcp-google-calendar --transport stdio`を直接実行してエラーを確認してください

### 認証情報をクリアしたい

```bash
mcp-google-calendar --clear-auth
```

## ライセンス

MIT License

## 開発者向け情報

開発者向けの詳細情報は [docs/README.dev.md](./docs/README.dev.md) を参照してください。