Skip to content

Commit 3a16b10

Browse files
authored
Add Gmail MCP Server for email operations (github#263)
- Supports listing messages, searching emails, and sending messages - Uses IMAP/SMTP with app password authentication - Includes proper tools.json for build process - Pre-built Docker image: yashtekwani/gmail-mcp:latest
1 parent b3ff1ba commit 3a16b10

File tree

2 files changed

+103
-0
lines changed

2 files changed

+103
-0
lines changed

servers/gmail-mcp/server.yaml

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
name: gmail-mcp
2+
image: yashtekwani/gmail-mcp
3+
type: server
4+
meta:
5+
category: communication
6+
tags:
7+
- email
8+
- gmail
9+
- imap
10+
- smtp
11+
- communication
12+
about:
13+
title: Gmail MCP Server
14+
description: A Model Context Protocol server for Gmail operations using IMAP/SMTP with app password authentication. Supports listing messages, searching emails, and sending messages.
15+
icon: https://www.google.com/gmail/about/static/images/logo-gmail.png
16+
source:
17+
project: https://github.com/Sallytion/Gmail-MCP
18+
config:
19+
description: Configure Gmail access with app password authentication
20+
secrets:
21+
- name: gmail-mcp.email_password
22+
env: EMAIL_PASSWORD
23+
example: <your-gmail-app-password>
24+
env:
25+
- name: EMAIL_ADDRESS
26+
27+
value: '{{gmail-mcp.email_address}}'
28+
- name: IMAP_HOST
29+
example: imap.gmail.com
30+
value: imap.gmail.com
31+
- name: IMAP_PORT
32+
example: "993"
33+
value: "993"
34+
- name: SMTP_HOST
35+
example: smtp.gmail.com
36+
value: smtp.gmail.com
37+
- name: SMTP_PORT
38+
example: "587"
39+
value: "587"
40+
parameters:
41+
type: object
42+
properties:
43+
email_address:
44+
type: string
45+
description: Your Gmail email address
46+
format: email
47+
required:
48+
- email_address

servers/gmail-mcp/tools.json

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
[
2+
{
3+
"name": "listMessages",
4+
"description": "List recent messages from Gmail inbox",
5+
"arguments": [
6+
{
7+
"name": "count",
8+
"type": "number",
9+
"desc": "Number of messages to retrieve (default: 10, max: 100)"
10+
}
11+
]
12+
},
13+
{
14+
"name": "findMessage",
15+
"description": "Search for messages containing specific words or phrases",
16+
"arguments": [
17+
{
18+
"name": "query",
19+
"type": "string",
20+
"desc": "Search query (supports Gmail search syntax)"
21+
}
22+
]
23+
},
24+
{
25+
"name": "sendMessage",
26+
"description": "Send an email message",
27+
"arguments": [
28+
{
29+
"name": "to",
30+
"type": "string",
31+
"desc": "Recipient email address"
32+
},
33+
{
34+
"name": "subject",
35+
"type": "string",
36+
"desc": "Email subject"
37+
},
38+
{
39+
"name": "body",
40+
"type": "string",
41+
"desc": "Email message body"
42+
},
43+
{
44+
"name": "cc",
45+
"type": "string",
46+
"desc": "CC email address (optional)"
47+
},
48+
{
49+
"name": "bcc",
50+
"type": "string",
51+
"desc": "BCC email address (optional)"
52+
}
53+
]
54+
}
55+
]

0 commit comments

Comments
 (0)