Remote-hostable server that gets and sends Gmail messages without local credential or file system setup.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add headless-gmail -- npx @peakmojo/mcp-server-headless-gmail~/.codex/config.toml
[mcp_servers.headless-gmail]
command = "npx"
args = ["@peakmojo/mcp-server-headless-gmail"]
# codex mcp add headless-gmail -- npx @peakmojo/mcp-server-headless-gmail~/.cursor/mcp.json
{
"mcpServers": {
"headless-gmail": {
"command": "npx",
"args": [
"@peakmojo/mcp-server-headless-gmail"
]
}
}
}.vscode/mcp.json
{
"servers": {
"headless-gmail": {
"type": "stdio",
"command": "npx",
"args": [
"@peakmojo/mcp-server-headless-gmail"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"headless-gmail": {
"command": "npx",
"args": [
"@peakmojo/mcp-server-headless-gmail"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"headless-gmail": {
"command": "npx",
"args": [
"@peakmojo/mcp-server-headless-gmail"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"headless-gmail": {
"command": "npx",
"args": [
"@peakmojo/mcp-server-headless-gmail"
]
}
}
}