publicCommunicationJan 1, 20260 calls

Gmail MCP Template

Curated MCP template for inbox search, thread summaries, drafts, and email workflows.

Hosted MCP endpoint

/api/mcp/preset-gmail

Private servers require an Astrail API key in the Authorization header.

MCP client snippets

Claude Desktop config

{
  "mcpServers": {
    "gmail-mcp-template": {
      "url": "/api/mcp/preset-gmail"
    }
  }
}

cURL initialize

curl -sS -X POST "/api/mcp/preset-gmail" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

cURL tools/list

curl -sS -X POST "/api/mcp/preset-gmail" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

cURL tools/call

curl -sS -X POST "/api/mcp/preset-gmail" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"gmail_search_messages","arguments":{"query":"example"}}}'

Runtime behavior

Runtime healthneeds_mapping

Endpoint healthnot_checked

Execution modemapping_required

Deterministic executionNot yet executable

Generated sourceExport only

Endpoint mapRequired

Endpoint mappedNo

Auth-required endpointsNone detected

Browser runtime endpointsNone detected

Last statusnot recorded

Last execution modenot recorded

Last toolnot recorded

Last latencynot recorded

Upstream statusnot recorded

Trace IDnot recorded

Error codenone

Observabilitystructured fallback

Rate limit modestandard

Missing authauth_required

Missing mappingmapping_required

Astrail does not evaluate generated TypeScript inside Next.js. Hosted calls are routed through stored tool metadata and endpoint maps.

Tools

gmail_search_messages

Search Gmail messages using Gmail query syntax.

gmail_get_thread

Fetch a Gmail thread with messages and participants.

gmail_create_draft

Create a draft reply for review before sending.

server.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "Gmail MCP Template", version: "1.0.0" });

// Curated Astrail template. Add the provider API token and replace the
// placeholder handlers with real fetch calls for: gmail_search_messages, gmail_get_thread, gmail_create_draft.

server.tool("template_status", "Confirm this curated MCP template is installed.", z.object({}), async () => ({
  content: [{ type: "text", text: "Template installed. Add provider credentials to enable live API calls." }],
}));

const transport = new StdioServerTransport();
await server.connect(transport);