Drupal Mail

Drupal mail system configuration for local testing (Mailpit) and production (Mailchimp Transactional). Covers HTML email rendering, Content-Type headers, sender/formatter plugins, and troubleshooting. Use when testing emails locally, debugging email issues, or configuring mail delivery.

84 stars 5 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add grasmash/drupal-claude-skills --skill drupal-mail
Manual install
git clone --depth 1 https://github.com/grasmash/drupal-claude-skills.git /tmp/drupal-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/drupal-claude-skills/skills/drupal-mail ~/.claude/skills/drupal-mail

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Drupal Mail System Configuration

## Quick Reference

### Local Testing (DDEV Mailpit)

**Working configuration for HTML emails in Mailpit:**
```yaml
# mailsystem.settings
defaults:
  sender: php_mail
  formatter: mailchimp_transactional_mail
```

**Enable/disable notifications:**
```bash
# Check if notifications are disabled
ddev drush state:get my_notifications.disabled

# Enable notifications (for local testing)
ddev drush state:set my_notifications.disabled 0

# Disable notifications (to stop local emails)
ddev drush state:set my_notifications.disabled 1
```

**View Mailpit:**
- URL: https://<project>.ddev.site:8026
- Or run: `ddev mailpit`

### Production Configuration

**Mailchimp Transactional (Mandrill) for sending:**
```yaml
# mailsystem.settings
defaults:
  sender: mailchimp_transactional_mail
  formatter: mailchimp_transactional_mail
```

## Mail System Architecture

### Key Concepts

1. **Sender**: The plugin that actually sends the email (SMTP, PHP mail(), API)
2. **Formatter**: The plugin that formats the email body (converts HTML, wraps content)
3. **Content-Type Header**: Must be set to `text/html` for HTML rendering

### Plugin Combinations

| Environment | Sender | Formatter | HTML Works? | Notes |
|------------|--------|-----------|-------------|-------|
| Local (Mailpit) | `php_mail` | `mailchimp_transactional_mail` | Yes | Recommended for local testing |
| Local (Mailpit) | `php_mail` | `php_mail` | No | Strips HTML to plain text |
Read the full skill on GitHub

Details

Skill name
drupal-mail
Path
skills/drupal-mail/SKILL.md
License
MIT
Repo updated
1 October 2026

FAQ

What does the Drupal Mail skill do?

Drupal mail system configuration for local testing (Mailpit) and production (Mailchimp Transactional). Covers HTML email rendering, Content-Type headers, sender/formatter plugins, and troubleshooting. Use when testing emails locally, debugging email issues, or configuring mail delivery.

How do I install the Drupal Mail skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add grasmash/drupal-claude-skills --skill drupal-mail. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Drupal Mail popular?

It lives in grasmash/drupal-claude-skills, which has 84 GitHub stars and 5 forks.

Related skills

Acquia Source

84

grasmash/drupal-claude-skills

Connect to an Acquia Source ("Source powered by Drupal CMS") site — its JSON:API and MCP endpoints, OAuth2 auth, the @drupal-canvas CLI, and the Canvas Page API deploy workflow. Use when wiring an AI agent or app to a Source CMS site, building/uploading Drupal Canvas Code Components, deploying landing pages via the Page API, or registering the Source MCP server with Claude Code/Cursor.

Frontend & Design

Canvas Contribution

84

grasmash/drupal-claude-skills

Workflow for contributing features and fixes to the Drupal Canvas module on drupal.org while consuming it from a separate project: the two-repository setup, Canvas UI development, issue forks, merge requests, and composer patches. Use when developing a Canvas feature or bug fix intended for upstream, or when moving a local Canvas change onto a drupal.org issue. Extends drupal-contrib-mgmt with Canvas-specific details.

Frontend & Design

Claude Code MCP Setup

84

grasmash/drupal-claude-skills

Add and configure MCP (Model Context Protocol) servers in Claude Code. Use when adding new MCP servers, configuring remote MCP, setting up OAuth MCP servers, troubleshooting MCP connections, or running /mcp diagnostics. Covers stdio, HTTP, and SSE transport types.

AI, LLMs & Agents

Workflow Skill

49

darrenhinde/Opencode-skills-example

Demonstrates script and custom tool working together with console output

Productivity & Notes15

Dida Task

49

lovekeji-ai/keji-skills

滴答清单(Dida365)任务管理工具。通过官方 OpenAPI + 私有 API,让 agent 能读取(任务、清单、已完成任务、番茄/专注统计)和写入(创建、更新、完成、删除任务和清单)滴答清单的数据。当用户提到"滴答"、"dida"、"清单"、"todo"、"任务"、"提醒"、"番茄钟"、"专注"且明显是要操作清单 App 时使用。不支持 TickTick 国际版,只支持国内 dida365。

Productivity & Notes

Datahub Connector Planning

46

datahub-project/datahub-skills

Plans new DataHub connectors by classifying the source system, researching it using a dedicated agent or inline research, and generating a _PLANNING.md blueprint with entity mapping and architecture decisions. Use when building a new connector, researching a source system for DataHub, or designing connector architecture. Triggers on: "plan a connector", "new connector for X", "research X for DataHub", "design connector for X", "create planning doc", or any request to plan/research/design a DataHub ingestion source.

Productivity & Notes98

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.