Mcp Server

Name: Mcp Server
Author: trasousa

@trasousa

代码仓库

关于 Mcp Server

暂无概览

#mcp-server #gmail #mcp

基本信息

分类

其他

许可证

Apache-2.0 license

运行时

python

传输方式

stdio

发布者

trasousa

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-trasousa": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "mcpo"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Gmail Server?

It is an MCP (Model Context Protocol) server for Gmail that exposes tools like list_unread and search_emails over the MCP protocol. It handles OAuth2 authentication with Google and is designed for integration with MCP clients such as Open WebUI.

How to use MCP Gmail Server?

Install dependencies with uv, place OAuth2 credentials in secrets/credentials.json, then run with uv run gmail-server. Alternatively, expose via mcpo using uvx mcpo --port 8000 --api-key "your-api-key" -- uv run gmail-server. Use any MCP‑compliant client to invoke the tools.

Key features of MCP Gmail Server

list_unread tool to retrieve unread Gmail message snippets.
search_emails tool to search by Gmail query.
Seamless OAuth2 flow with token caching.
Asyncio‑based server compatible with MCP clients.
Can be wrapped with mcpo for HTTP/OpenAPI endpoints.

Use cases of MCP Gmail Server

Quickly check unread emails through an AI assistant.
Search for specific emails by sender or subject.
Integrate Gmail functionality into Open WebUI workflows.
Deploy as a containerized service using Docker.

FAQ from MCP Gmail Server

What tools does the server provide?

Two tools: list_unread (returns unread email snippets) and search_emails (returns emails matching a Gmail query).

What are the prerequisites?

Python 3.13 or newer, uv package manager, a Google account, and access to Google Cloud Console for Gmail API credentials.

How do I set up Gmail API credentials?

Create a project in Google Cloud Console, enable the Gmail API, configure an OAuth consent screen with your email as a test user, create an OAuth client ID for a desktop app, and place the downloaded JSON as secrets/credentials.json.

How do I run the server?

Run uv run gmail-server directly, or expose via mcpo with uvx mcpo --port 8000 --api-key "your-api-key" -- uv run gmail-server. The first run will prompt OAuth authorization in the browser.

Where are OAuth tokens stored?

A cached token is automatically saved to secrets/token.json after the first authorization, so subsequent runs do not require re‑authentication.

其他分类下的更多 MCP 服务器

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K