Gmail MCP Server 7im

🚀 Gmail MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Gmail API. This server enables you to programmatically manage emails through the MCP interface.

✨ Features

Gmail Tools

• list_emails: List recent emails in the inbox with optional filtering.
• search_emails: Advanced email search using Gmail query syntax.
• send_email: Send new emails, supporting CC and BCC.
• modify_email: Modify email labels (archive, move to spam, mark as read/unread).

📋 Prerequisites

1. Node.js: Install Node.js version 14 or higher.
2. Google Cloud Console Setup:
   • Visit Google Cloud Console.
   • Create a new project or select an existing one.
   • Enable the Gmail API:
     1. Go to "APIs & Services" > "Library".
     2. Search for and enable "Gmail API".
   • Set up OAuth 2.0 credentials:
     1. Go to "APIs & Services" > "Credentials".
     2. Click "Create Credentials" > "OAuth client ID".
     3. Select "Web application".
     4. Set "Authorized redirect URIs" to include: http://localhost:3001/code.
     5. Note down the Client ID and Client Secret.

📦 Installation

1. Clone and Install:

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

2. Create OAuth Credentials: Create a credentials.json file in the root directory:

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:3001/code"],
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token"
       }
   }
   

3. Get Refresh Token:

   node get-refresh-token.js
   

   This will:

   • Open the browser for Google OAuth authentication.
   • Request the following permissions:
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/gmail.send
   • Save the credentials to token.json.
   • Display the refresh token in the console.

4. Configure MCP Settings: Add the server configuration to your MCP settings file:

   • For the VSCode Claude extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • For the Claude desktop app: ~/Library/Application Support/Claude/claude_desktop_config.json

   Add the following to the mcpServers object:

   {
     "mcpServers": {
       "google-gmail": {
         "command": "node",
         "args": ["/path/to/google-gmail-mcp-server/index.js"],
         "env": {}
       }
     }
   }
   

5. Run the Server:

   npm start
   

💻 Usage Examples

Basic Usage

List Emails

{
  "command": "_gmail.list_emails",
  "args": {
    "userId": "me"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

Search Emails

{
  "command": "_gmail.search_emails",
  "args": {
    "userId": "me",
    "query": "inbox is:unread label:important"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

Send Email

{
  "command": "_gmail.send_email",
  "args": {
    "userId": "me",
    "email": {
      "to": "recipient@example.com",
      "subject": "Test Email",
      "bodyText": "This is a test email."
    }
  },
  "response": {
    "data": {
      "id": "string"
    }
  }
}

Modify Email

{
  "command": "_gmail.modify_email",
  "args": {
    "userId": "me",
    // The rest of the code for modifying email...
  }
}