Skip to main content
Glama
nvsd

gmail-fan

by nvsd

gmail-fan

本地优先的 macOS Gmail 网关:将多个 Gmail 或 Google Workspace 账户同步到 SQLite,快速搜索它们,并通过 JSON 命令行和本地 stdio MCP 服务器暴露相同的操作。

Gmail 是唯一事实来源。OAuth 令牌存储在 macOS Keychain 中。不捆绑模型、嵌入索引或模型提供商 SDK。

要求

  • macOS(Keychain + LaunchAgent)

  • Bun 1.4 或更高版本

  • 一个启用了 Gmail API 且带有 OAuth Desktop 客户端 JSON 的 Google Cloud 项目

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。命令行:docs/cli.md。MCP:docs/mcp.md。演示:docs/demo.md

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    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
  • 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
  • A
    license
    A
    quality
    B
    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
    MIT

View all related MCP servers

Related MCP Connectors

  • Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

  • Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

  • Search Hacker News, Bluesky, and Substack from a single MCP interface

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nvsd/gmail-fan'

If you have feedback or need assistance with the MCP directory API, please join our Discord server