Gmail MCP サーバー

Gmail と Claude Desktop を統合するモデルコンテキストプロトコル (MCP) サーバー。これにより、Claude は適切なコンテキスト管理とプライバシー制御を維持しながら、メールの内容にアクセスして理解できるようになります。

特徴

OAuth2認証によるGmail API統合
安全なトークン管理と保管
プライバシー重視のデータ処理
クロードのコンテキストウィンドウ管理
包括的なログ記録とエラー処理
簡単に導入できるDockerサポート

前提条件

Node.js >= 18.0.0
npmまたはyarn
Gmail API が有効になっている Google Cloud プロジェクト
クロードAPIキー

設定

リポジトリをクローンします。

git clone https://github.com/yourusername/gmail-mcp-server.git
cd gmail-mcp-server

依存関係をインストールします:

npm install

次の変数を含む.envファイルをルートディレクトリに作成します。

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback
CLAUDE_API_KEY=your_claude_api_key
PORT=3000

開発サーバーを起動します。

npm run dev

発達

npm run dev : ホットリロードで開発サーバーを起動する
npm test : テストを実行する
npm run lint : ESLint を実行する

プロジェクト構造

gmail-mcp-server/
├── src/
│   ├── server.js          # Main server entry point
│   ├── auth.js            # Authentication handling
│   ├── gmail.js           # Gmail API integration
│   ├── claude.js          # Claude API integration
│   ├── logger.js          # Logging configuration
│   └── utils/             # Utility functions
├── tests/                 # Test files
├── .env                   # Environment variables
├── .gitignore            # Git ignore rules
├── package.json          # Project dependencies
└── README.md             # Project documentation

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

Gmail MCP Server

Integrations

Gmail MCP サーバー

特徴

前提条件

設定

発達

プロジェクト構造

貢献

ライセンス