Gmail Send Skill

Send emails via Gmail SMTP with Markdown-to-HTML conversion.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/baddif/mcp-server-gmail-send --skill gmail-send-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Gmail Send Skill
Source: https://github.com/baddif/mcp-server-gmail-send/tree/main
Command: npx skills add https://github.com/baddif/mcp-server-gmail-send --skill gmail-send-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, typer[all].

What problem does it solve?

It eliminates the manual, error-prone process of composing and sending emails by turning Markdown content into email-safe HTML and dispatching it through Gmail SMTP with App Password authentication.

Core Features & Use Cases

  • Gmail SMTP Email Sending: Sends emails using Gmail’s SMTP server with TLS and App Password login.
  • Markdown to HTML Conversion (with fallback): Produces email-compatible HTML from Markdown, including enhanced styling when the markdown library is available.
  • Validation & Rich Error Reporting: Validates inputs (emails, required fields, App Password format) and returns structured success/error feedback suitable for AI agents.

Quick Start

Ask your AI to call the gmail_send function with your Gmail username, your 16-character Gmail App Password, the recipient address, an email subject, and Markdown content to send the message.

Frequently Asked Questions about Gmail Send Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send Markdown emails via Gmail SMTP using an App Password?

To send Markdown emails via Gmail SMTP, provide your Gmail username, a 16-character App Password, recipient address, subject, and Markdown content. The tool validates inputs, converts Markdown to email-safe HTML, and dispatches the message over a TLS connection on port 587.

Can I use this Gmail SMTP tool for direct AI agent function calls?

Yes, the Gmail SMTP tool supports AI agent tool execution scenarios including direct function calls via gmail_send, MCP resource reads for status and last_result, and CLI-based sending for testing. It returns structured success/error feedback suitable for programmatic agent consumption.

Do I need a standard Gmail password to authenticate SMTP email sending?

No, you do not use your standard Gmail password for SMTP email sending. You must generate a 16-character Gmail App Password to authenticate the TLS SMTP connection on port 587, ensuring secure access without exposing your primary account credentials.

What happens if the Markdown to HTML conversion fails during email sending?

If the Markdown to HTML conversion encounters issues during email sending, the tool implements a graceful fallback mechanism. It ensures the content is still processed and dispatched as email-safe HTML, maintaining delivery even when the markdown library encounters formatting anomalies.

How does the tool validate email sending parameters for AI agents?

The tool enforces strict parameter validation for required fields and formats, including recipient addresses and the 16-character App Password structure. It generates rich error reporting to provide structured, standardized success/error feedback specifically designed for AI agent consumption.

What is the best way to test CLI-based Gmail sending locally?

The best way to test Gmail sending locally is through the built-in CLI functionality. You can execute test sends by providing the required runtime parameters directly via the command line, validating the Markdown to HTML conversion and SMTP dispatch before integrating with an AI agent.