Google ADK Integration

How It Works

Google ADK supports the Model Context Protocol (MCP) natively. Dead Simple Email ships an MCP server that exposes all 11 email tools. You point ADK at the MCP server, and your Gemini-powered agent gets full email capabilities without writing any tool definitions or API glue code.

Quick Start: Python

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import MCPToolset
from mcp import StdioServerParameters

email_tools = MCPToolset(
    connection_params=StdioServerParameters(
        command="python",
        args=["-m", "deadsimple.mcp"],
        env={"DSE_API_KEY": "dse_your_api_key"},
    )
)

agent = LlmAgent(
    model="gemini-2.5-pro",
    name="email_agent",
    instruction="You manage email for the team using Dead Simple Email.",
    tools=[email_tools],
)

The MCPToolset launches the Dead Simple MCP server as a subprocess and discovers all available tools automatically. Your agent can immediately create inboxes, send emails, read messages, and manage webhooks.

Quick Start: TypeScript

import { LlmAgent } from "@google/adk";
import { MCPToolset, StdioServerParameters } from "@google/adk/tools";

const emailTools = new MCPToolset({
  connectionParams: new StdioServerParameters({
    command: "python",
    args: ["-m", "deadsimple.mcp"],
    env: { DSE_API_KEY: "dse_your_api_key" },
  }),
});

const agent = new LlmAgent({
  model: "gemini-2.5-pro",
  name: "email_agent",
  instruction: "You manage email using Dead Simple Email.",
  tools: [emailTools],
});

The TypeScript integration works the same way. ADK launches the MCP server process, discovers tools via the MCP protocol, and makes them available to the Gemini model as callable functions.

Under the Hood: MCP

Google ADK connects through the Dead Simple MCP server. All 11 MCP tools are available automatically. No separate package is needed beyond the MCP server (pip install deadsimple[mcp]).

The MCP server handles authentication, request serialization, and error handling. ADK handles tool discovery and the conversation loop. Your code just connects the two.

Available MCP tools include inbox management, email sending and reading, reply threading, webhook configuration, and attachment handling. See the Integrations overview for the full list.