Advertise
MCP.so
Sign In

MCP Server

@trasousa

Repository

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

trasousa

About MCP Server

No overview available yet

#mcp-server#gmail#mcp

MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

1

What tools does the server provide?

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

2

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.

3

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`.

4

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.

5

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.

Comments

More Other MCP servers

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
Advertise