Skip to main content
Glama
deenesjakoruzh
nvsd

gmail-fan

by nvsd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

gmail-f-mcp

로컬 우선 macOS Gmail 게이트웨이: 여러 Gmail 또는 Google Workspace 계정을 SQLite로 동기화하고, 이메일을 빠르게 검색하며, 동일한 작업을 JSON CLI와 로컬 stdio MCP 서버를 통해 노출합니다.

Gmail이 소스 오브 트루스입니다. OAuth 토큰은 macOS Keychain에 저장됩니다. 번들로 포함된 모델, 임베딩 인덱스 또는 모델 제공자 SDK는 없습니다.

요구 사항

  • macOS (Keychain + LaunchAgent)

  • Bun 1.4 이상

  • Gmail API가 활성화된 Google Cloud 프로젝트와 OAuth Desktop 클라이언트 JSON 파일

Related MCP server: Gmail Local MCP

설치 및 첫 계정

bun install
bun run build
bun src/cli/main.ts init --oauth-client ./client_secret.json
bun src/cli/main.ts accounts add --alias work
bun src/cli/main.ts sync
bun src/cli/main.ts search "quarterly planning" --json

프로덕션 경로:

~/Library/Application Support/gmail-fan/
~/Library/Logs/gmail-fan/

개발

bun install
bun run test:unit
bun run test:integration
bun run typecheck
bun run check
bun run build

아키텍처

Gmail accounts
      ↓
Gmail API + separate OAuth grant per account
      ↓
Synchronization service
      ↓
SQLite + FTS5
      ↓
Shared application service layer
      ↓
CLI            Local MCP server (stdio)

기술 결정: docs/adr. 보안: docs/security.md. CLI: docs/cli.md. MCP: docs/mcp.md. 데모: docs/demo.md.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • google-mcp

    giantrotta24
    A
    license
    B
    quality
    C
    maintenance
    Multi-account Google MCP server providing read access to Gmail and Calendar via stdio. Supports secure authentication for personal and work accounts with OAuth and keychain token storage.
    4
    MIT

  • Gmail Local MCP

    mattgotteiner
    A
    license
    Not graded
    quality
    D
    maintenance
    Local stdio MCP server that mirrors the public Gmail MCP server tool surface while calling the Gmail REST API directly, enabling email management tasks like creating drafts, searching threads, and managing labels.
    MIT

  • email-mcp

    swapnilsurdi
    A
    license
    A
    quality
    D
    maintenance
    Local MCP server for multi-account IMAP/SMTP email (iCloud + Gmail via app-specific passwords). Never marks mail read. Cross-folder search, idempotent sends, TLS verified.
    8
    11 PyPI
    MIT

  • mcp-gmail-oauth

    flujo-app
    A
    license
    Not graded
    quality
    C
    maintenance
    A self-hostable Gmail MCP server that enables Gmail search/read, sending, replies, drafts, labels, and attachment downloads via MCP tools with OAuth authorization. Supports stdio and streamable HTTP transports.
    1
    MIT