gmail-power-cli

colespen/gmail-power-cli

3.1

If you are the rightful owner of gmail-power-cli and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate seamless integration between command-line applications and AI assistants, enabling enhanced functionality and user interaction.

Gmail Power CLI

🚧 WIP - Work in Progress

A command-line interface for Gmail that integrates with various LLM's through MCP servers

  • Antrhopic
  • Gemini
  • Groq (currently using ~ best free tier)

CLI example: CLI Example

Features

  • Search Gmail messages with natural language queries
  • Read email content and metadata
  • AI-powered email interactions via Gemini integration
  • MCP server for Claude desktop integration

Setup

  1. Install dependencies:

    npm install

  2. Set up Google Cloud Console:

    • Create project at https://console.cloud.google.com
    • Enable Gmail API
    • Data Access / scopes: gmail.modify
    • Create OAuth 2.0 credentials (Desktop application)
    • Download credentials.json to project root

  3. Configure environment variables: Create a .env file:

    Currently most success using Groq free tier:

    Get your free API key from: https://console.groq.com/keys

    GROQ_API_KEY=your-groq-api-key

  4. Authenticate with Gmail:

    npm run auth

Usage

CLI Mode:

npm run gmail

MCP Server Mode:

npm run start

Development:

npm run dev