How do I install the Email Sending skill?

Run npx skillmds@latest add eng-muhammad-affan/email-sending in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Email Sending safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Email Sending?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Email Sending free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Email Sending?

Eng-Muhammad-Affan (@eng-muhammad-affan) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Email Sending by eng-muhammad-affan

Name: Email Sending
Author: Eng-Muhammad-Affan

Email Sending

Send emails via Gmail using the Email MCP server. Supports sending, drafting, searching emails, and marking as read. Use when tasks require email communication, sending invoices, replying to clients, or managing Gmail inbox.

File contents

Email Sending Skill

Send and manage emails via Gmail MCP server built with FastMCP.

MCP Server Setup

Start Email MCP Server

# Start with stdio transport (for Claude Code integration)
uv run python mcp-servers/email/server.py

# Or start with HTTP transport
uv run python mcp-servers/email/server.py --transport http --port 8801

Configure Claude Code MCP

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": ["run", "python", "mcp-servers/email/server.py"]
    }
  }
}

Gmail API Setup

Go to Google Cloud Console
Create a new project
Enable Gmail API
Create OAuth 2.0 credentials
Download credentials.json
Place in ~/.gmail_watcher/credentials.json
First run will auto-generate token

Tools

send_email

Send an email via Gmail.

uv run python scripts/mcp-client.py call -t send_email -p '{
  "to": "client@example.com",
  "subject": "Invoice #123",
  "body": "Please find attached your invoice...",
  "html": false
}'

Parameters:

to (required): Recipient email address
subject (required): Email subject
body (required): Email body content
from_email (optional): Sender email
cc (optional): CC recipients (comma-separated)
bcc (optional): BCC recipients (comma-separated)
html (optional): Whether body is HTML (default: false)

draft_email

Create a draft email in Gmail (does not send).

uv run python scripts/mcp-client.py call -t draft_email -p '{
  "to": "client@example.com",
  "subject": "Proposal for Project",
  "body": "Dear Client, Here is the proposal..."
}'

search_emails

Search emails in Gmail.

# Find unread emails
uv run python scripts/mcp-client.py call -t search_emails -p '{
  "query": "is:unread",
  "max_results": 10
}'

# Find emails from specific sender
uv run python scripts/mcp-client.py call -t search_emails -p '{
  "query": "from:client@example.com",
  "max_results": 5
}'

Parameters:

query (required): Gmail search query
max_results (optional): Maximum results (default: 10)

get_email_content

Get full content of a specific email.

uv run python scripts/mcp-client.py call -t get_email_content -p '{
  "message_id": "123abc"
}'

mark_as_read

Mark an email as read.

uv run python scripts/mcp-client.py call -t mark_as_read -p '{
  "message_id": "123abc"
}'

Workflow: Reply to Client Email

Search for unread emails
Get email content
Draft reply (requires approval)
On approval, send email

Workflow: Send Invoice

Create invoice PDF
Draft email with attachment
Create approval file in /Pending_Approval/
On approval (file moved to /Approved/), send email

Environment Variables

# Gmail credentials
GMAIL_CREDENTIALS_PATH=~/.gmail_watcher/credentials.json
GMAIL_TOKEN_PATH=~/.gmail_watcher/token.json

# Dry run mode
DRY_RUN=true  # Set to 'false' for production

Troubleshooting

Issue	Solution
Authentication failed	Re-run server to trigger OAuth flow
Credentials not found	Download from Google Cloud Console
Email not sending	Check DRY_RUN environment variable
API quota exceeded	Wait and retry, or increase quota

Related Skills

linkedin-posting - Social media posting
whatsapp-monitoring - WhatsApp message monitoring

---name: email-sendingdescription: Send emails via Gmail using the Email MCP server. Supports sending, drafting, searching emails, and marking as read. Use when tasks require email communication, sending invoices, replying to clients, or managing Gmail inbox.---# Email Sending SkillSend and manage emails via Gmail MCP server built with FastMCP.## MCP Server Setup### Start Email MCP Server```bash# Start with stdio transport (for Claude Code integration)uv run python mcp-servers/email/server.py# Or start with HTTP transportuv run python mcp-servers/email/server.py --transport http --port 8801```### Configure Claude Code MCPAdd to your Claude Code MCP configuration:```json{ "mcpServers": { "email": { "command": "uv", "args": ["run", "python", "mcp-servers/email/server.py"] } }}```### Gmail API Setup1. Go to [Google Cloud Console](https://console.cloud.google.com/)2. Create a new project3. Enable Gmail API4. Create OAuth 2.0 credentials5. Download `credentials.json`6. Place in `~/.gmail_watcher/credentials.json`7. First run will auto-generate token## Tools### send_emailSend an email via Gmail.```bashuv run python scripts/mcp-client.py call -t send_email -p '{ "to": "client@example.com", "subject": "Invoice #123", "body": "Please find attached your invoice...", "html": false}'```**Parameters:**- `to` (required): Recipient email address- `subject` (required): Email subject- `body` (required): Email body content- `from_email` (optional): Sender email- `cc` (optional): CC recipients (comma-separated)- `bcc` (optional): BCC recipients (comma-separated)- `html` (optional): Whether body is HTML (default: false)### draft_emailCreate a draft email in Gmail (does not send).```bashuv run python scripts/mcp-client.py call -t draft_email -p '{ "to": "client@example.com", "subject": "Proposal for Project", "body": "Dear Client, Here is the proposal..."}'```### search_emailsSearch emails in Gmail.```bash# Find unread emailsuv run python scripts/mcp-client.py call -t search_emails -p '{ "query": "is:unread", "max_results": 10}'# Find emails from specific senderuv run python scripts/mcp-client.py call -t search_emails -p '{ "query": "from:client@example.com", "max_results": 5}'```**Parameters:**- `query` (required): Gmail search query- `max_results` (optional): Maximum results (default: 10)### get_email_contentGet full content of a specific email.```bashuv run python scripts/mcp-client.py call -t get_email_content -p '{ "message_id": "123abc"}'```### mark_as_readMark an email as read.```bashuv run python scripts/mcp-client.py call -t mark_as_read -p '{ "message_id": "123abc"}'```## Workflow: Reply to Client Email1. Search for unread emails2. Get email content3. Draft reply (requires approval)4. On approval, send email## Workflow: Send Invoice1. Create invoice PDF2. Draft email with attachment3. Create approval file in `/Pending_Approval/`4. On approval (file moved to `/Approved/`), send email## Environment Variables```bash# Gmail credentialsGMAIL_CREDENTIALS_PATH=~/.gmail_watcher/credentials.jsonGMAIL_TOKEN_PATH=~/.gmail_watcher/token.json# Dry run modeDRY_RUN=true # Set to 'false' for production```## Troubleshooting| Issue | Solution ||-------|----------|| Authentication failed | Re-run server to trigger OAuth flow || Credentials not found | Download from Google Cloud Console || Email not sending | Check DRY_RUN environment variable || API quota exceeded | Wait and retry, or increase quota |## Related Skills- [linkedin-posting](../linkedin-posting/) - Social media posting- [whatsapp-monitoring](../whatsapp-monitoring/) - WhatsApp message monitoring

Frequently asked questions