Claude Email Analysis MCP Server

A simple server that uses Claude's API to analyze emails from Gmail.

Setup

1. Clone the repository

2. Install dependencies

   npm install
   

3. Set up Google OAuth credentials:

   • Go to the Google Cloud Console
   • Create a new project
   • Enable the Gmail API
   • Configure the OAuth consent screen
   • Create OAuth client ID credentials (Web application)
   • Add http://localhost:3000/api/auth/google/callback as an authorized redirect URI

4. Create a .env file in the root directory with the following variables:

   PORT=3000
   CLAUDE_API_KEY=your_claude_api_key_here
   GOOGLE_CLIENT_ID=your_google_client_id_here
   GOOGLE_CLIENT_SECRET=your_google_client_secret_here
   REDIRECT_URI=http://localhost:3000/api/auth/google/callback
   

Running the server

Development mode:

npm run dev

Production mode:

npm run build
npm start

Then open your browser to http://localhost:3000 to use the web interface.

API Endpoints

Authentication

Start Google OAuth Flow

GET /api/auth/google

Redirects the user to Google's OAuth consent page.

OAuth Callback

GET /api/auth/google/callback

Google redirects back to this endpoint after the user grants permission.

Auth Status

GET /api/success

Returns authentication status.

Email Analysis

Analyze Gmail Messages

GET /api/emails?count=5

Fetches and analyzes recent emails from the authenticated Gmail account.

• count (query parameter): Number of emails to fetch (default: 5)

Response:

{
  "count": 5,
  "emails": [
    {
      "id": "email_id",
      "subject": "Email subject",
      "from": "sender@example.com",
      "snippet": "Email preview...",
      "analysis": "Claude's analysis of the email..."
    },
    ...
  ]
}

Analyze Specific Email

GET /api/emails/:emailId

Fetches and analyzes a specific email from the authenticated Gmail account.

Response:

{
  "id": "email_id",
  "subject": "Email subject",
  "from": "sender@example.com",
  "snippet": "Email preview...",
  "body": "Full email body...",
  "analysis": "Claude's analysis of the email..."
}

Analyze Custom Email Content

POST /api/analyze-email

Analyzes custom email content without requiring Gmail authentication.

Request body:

{
  "emailContent": "Your email content here..."
}

Response:

{
  "analysis": "Claude's analysis of the email..."
}

Error Handling

The server returns appropriate HTTP status codes:

• 400: Bad request (missing required fields)
• 401: Unauthorized (Gmail authentication required)
• 500: Server error (API error, etc.)