gmailql 1.0.2

GmailQL

Email operations via GraphQL -- CLI tool, MCP server, and API for Gmail and IMAP/SMTP providers.

Install

# Zero-install via .NET 10 dnx
dnx gmailql

# Or install as a global tool
dotnet tool install -g gmailql

Quick Start

# Log in to Gmail
gmailql login

# List inbox messages
gmailql messages list

# Read a message
gmailql messages read <id>

# Send a message
gmailql messages send --to alice@example.com --subject "Hello" --body "Hi there"

# Search messages
gmailql messages list --query "from:bob subject:meeting"

# Raw GraphQL query
gmailql query '{ messages(filter: { isUnread: true }) { items { subject from { email } } } }'

MCP Server

GmailQL includes an MCP server for AI agent integration with 3 tools: gmailql_query, gmailql_mutate, gmailql_schema.

# Start in MCP mode
gmailql --mcp

# Auto-detected when stdin is piped
echo '{}' | gmailql

Configure in Claude Code settings.json:

{
  "mcpServers": {
    "gmailql": {
      "command": "dnx",
      "args": ["gmailql", "--mcp"]
    }
  }
}

HTTP GraphQL Server

cd src/GmailQL.Server
dotnet run
# GraphQL playground at http://localhost:5280/graphql

IMAP/SMTP Support

# Log in to any IMAP provider
gmailql login --provider imap --alias work

Features

• 30 CLI commands covering messages, drafts, labels, contacts, filters, attachments
• GraphQL API with 10 queries and 18 mutations
• MCP server with 3 coarse tools for minimal AI context usage
• Multi-account with named accounts and switching
• Interactive prompts when arguments are missing
• JSON output (--json) for scripting
• Layered skill docs for AI agent context efficiency

Development

dotnet build gmailql.slnx
dotnet test gmailql.slnx
dotnet pack src/GmailQL.Tool/GmailQL.Tool.csproj -c Release

License

MIT