mariana-google-mcp

Claude CodeからGmail、Googleカレンダー、Google連絡先にアクセスできるようにするカスタムMCP（Model Context Protocol）サーバーです。安全性を最優先したデフォルト設定になっています。

設計思想

このサーバーは、誤操作による損害のリスクなしに、AIにGoogleワークスペースの管理を支援させたいユーザーのために構築されています。

メールの送信不可。 下書きは作成できますが、送信にはGmailでの手動操作が必要です。
削除の禁止。 Gmailでは「To Be Deleted（削除予定）」ラベルを使用します（ソフトデリート）。カレンダーではイベントタイトルの先頭に「DELETE - 」を付加します。Google UI上で確認し、実行してください。
すべての変更をログに記録。 追記専用のJSONLアクションログに、タイムスタンプ、ツール名、アカウント、概要を含むすべての書き込み操作が記録されます。
マルチアカウント対応。 個人用アカウントと仕事用アカウントを名前付きエイリアスで管理できます。

セットアップ

1. Google Cloudプロジェクト

Google Cloud Console にアクセスします
新しいプロジェクトを作成する（または既存のものを使用する）
以下のAPIを有効にします：
- Gmail API
- Google Calendar API
- People API（連絡先用）
OAuth 2.0認証情報を作成します：
- アプリケーションの種類：デスクトップアプリ
- クライアントIDとクライアントシークレットをダウンロードします

2. インストールとビルド

git clone https://github.com/marianasmall/mariana-google-mcp.git
cd mariana-google-mcp
npm install
npm run build

3. Claude Codeへの追加

~/.claude.json の mcpServers に以下を追加します：

{
  "mcpServers": {
    "mariana-google-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mariana-google-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

/path/to/ を実際のクローン先パスに置き換え、OAuth認証情報を入力してください。

4. 認証

Claude Codeを再起動した後、google_auth ツールを実行します。OAuth同意のためのブラウザウィンドウが開きます。認証が完了すると、トークンがローカルに保存され、自動的に更新されます。

利用可能なツール (19)

認証とステータス

ツール	説明
`google_auth`	OAuthブラウザフローを介してGoogleアカウントを認証する
`google_status`	設定されたすべてのアカウントの接続状態を確認する

Gmail (9ツール)

ツール	説明
`gmail_search`	Gmailのクエリ構文を使用してメッセージを検索する
`gmail_read`	IDを指定して特定のメッセージを読み取る（全文）
`gmail_list_labels`	すべてのGmailラベル/フォルダを一覧表示する
`gmail_draft`	メールの下書きを作成する（送信はしません）
`gmail_create_label`	新しいラベルを作成する（`/`によるネストをサポート）
`gmail_apply_label`	1つ以上のメッセージにラベルを適用する
`gmail_remove_label`	1つ以上のメッセージからラベルを削除する
`gmail_create_filter`	フィルタールールを作成する（一致条件 → アクション）
`gmail_move_to_delete`	ソフトデリート：「To Be Deleted」ラベルにメッセージを移動する

カレンダー (6ツール)

ツール	説明
`calendar_list`	今後のカレンダーイベントを一覧表示する
`calendar_search`	キーワードでイベントを検索する
`calendar_get`	特定のイベントの詳細を取得する
`calendar_create`	イベントを作成する（デフォルトでは招待メールを送信しません）
`calendar_update`	既存のイベントを変更する（デフォルトでは参加者に通知しません）
`calendar_flag_delete`	ソフトデリート：イベントタイトルの先頭に「DELETE - 」を付加する
`calendar_availability`	指定期間の空き状況を確認する

連絡先 (2ツール)

ツール	説明
`contacts_search`	名前、メールアドレス、電話番号で連絡先を検索する
`contacts_list`	連絡先を一覧表示する（グループによるフィルタリングが可能）

マルチアカウント対応

複数のGoogleアカウントをわかりやすい名前で認証できます：

google_auth account_name: "primary"
google_auth account_name: "newsletters"
google_auth account_name: "work"

ほとんどのツールはオプションの account パラメータを受け付けます。省略した場合はデフォルトのアカウントが使用されます。google_status を使用して、設定済みのアカウントとその状態を確認してください。

設定ファイル

すべての設定は ~/.config/mariana-google-mcp/ に保存されます：

ファイル	用途
`config.json`	アカウントレジストリ（名前、メールハッシュ、デフォルト設定）
`tokens/<hash>.json`	アカウントごとのOAuthトークン（自動更新）
`actions.jsonl`	すべての変更操作の追記専用ログ

トークンは、間接的なレイヤーとして、メールアドレスのプレーンテキストではなくハッシュ値で保存されます。

アクションログ

すべての書き込み操作（下書き作成、カレンダー作成/更新、ソフトデリート）は、以下の形式で ~/.config/mariana-google-mcp/actions.jsonl に記録されます：

{"timestamp":"2026-04-03T10:30:00.000Z","tool":"gmail_draft","account":"primary","summary":"Draft created: subject='Meeting follow-up'"}

ログは追記専用であり、サーバーによって変更されることはありません。Claudeが行った操作を監査するためにいつでも確認できます。

フォークと利用

自分のGoogleアカウントでこれを使用するには：

このリポジトリをフォークする
独自のGoogle CloudプロジェクトとOAuth認証情報を作成する（上記のセットアップを参照）
ビルドし、Claude Codeの設定でフォーク先の dist/index.js を指定する
google_auth を実行して認証する

コードの変更は不要です。アカウント固有のデータはすべて設定ファイルと環境変数に保存されます。

技術スタック

TypeScript
@modelcontextprotocol/sdk — MCPプロトコル実装
googleapis — Google APIクライアント
google-auth-library — OAuth2トークン管理
zod — 入力バリデーション

ライセンス

MIT

Mariana Google MCP