clean-contact-list

clean-contact-list is a skill for Claude Code from Misar-AI/misarmail-mcp. It costs 44 tokens per session (344 once invoked), scanned A, original, MIT.

A procedure for checking and improving an email contact list by examining bounced, complained-about, and inactive contacts. List hygiene means removing or separating addresses that should not receive more email.

In plain words
What is it for?
Use it to analyse contact-list quality, plan suppression or re-engagement, and import opted-in contacts without creating duplicates.
Why use it?
It helps reduce delivery problems and protect sender reputation while avoiding accidental removal of contacts without approval.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the misarmail plugin — 9 skills, 3 agents, 2 MCP servers shipped together

Good fit Use it to analyse contact-list quality, plan suppression or re-engagement, and import opted-in contacts without creating duplicates.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/misar-ai/misarmail-mcp/clean-contact-list
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Misar-AI/misarmail-mcp --skill clean-contact-list
Clone the repo
git clone --depth 1 https://github.com/Misar-AI/misarmail-mcp

Made for: Claude Code.

Or install misarmail, the plugin that ships this one along with the rest of its 9 skills, 3 agents, 2 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for clean-contact-list

README.md
[![agentmods](https://agentmods.dev/badge/skills/misar-ai/misarmail-mcp/clean-contact-list/github.svg)](https://agentmods.dev/skills/misar-ai/misarmail-mcp/clean-contact-list)
Your own site
<a href="https://agentmods.dev/skills/misar-ai/misarmail-mcp/clean-contact-list"><img src="https://agentmods.dev/badge/skills/misar-ai/misarmail-mcp/clean-contact-list/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for clean-contact-list

Your own site · 80×15
<a href="https://agentmods.dev/skills/misar-ai/misarmail-mcp/clean-contact-list"><img src="https://agentmods.dev/badge/skills/misar-ai/misarmail-mcp/clean-contact-list.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 344 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.00344
Opus 5 $0.00022 $0.00172
Sonnet 5 $0.00009 $0.00069
Haiku 4.5 $0.00004 $0.00034

Measured 10d ago against content hash e9094a1915a2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

clean-contact-list scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/clean-contact-list/SKILL.md · 38 lines

What it actually says

Clean a contact list

Assess

  • list_contacts with status=bounced and status=complained — these must never be mailed again. Continuing to send to them is what turns a reputation problem into a blocklisting.
  • get_contact_score with no contact_id returns the lowest-engagement contacts.
  • get_analytics for the open-rate trend over time.

Report what share of the list each category represents. Percentages, not raw counts alone — "412 bounced" means nothing without the list size.

Recommend, then ask

Propose which segments to suppress and which to try re-engaging first. A re-engagement campaign to genuinely unengaged contacts is usually worth one attempt before suppression; contacts who complained are not.

Never call update_contact to unsubscribe anyone without explicit per-segment approval. Unsubscribing is effectively irreversible from the user's perspective and they may be reacting to a number they misread.

Importing

When importing, import_contacts handles up to 5,000 per call and updates rather than duplicates existing addresses. Before a large import, confirm the contacts opted in — mailing a purchased or scraped list breaches CAN-SPAM and GDPR and will damage the sending domain for every other campaign.

Spot-check a sample with validate_email first and report the rejected rows.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 38 lines · 44 tokens per session scan A e9094a1915a2

Subscribe to this mod's changes

clean-contact-list is a skill published in the GitHub repository Misar-AI/misarmail-mcp (1 stars, last pushed 2d ago), licensed MIT. It adds 44 tokens to every session and 344 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

email-automation-builder

Build multi-sequence email automation flows with branching logic. Triggers on: "build email automation", "create email funnel", "email automation flow", "welcome series with branches", "conditional email sequence", "set up automation", "email workflow builder", "segmented email flow", "advanced email sequence"…

Affitor/affiliate-skills · 84 tokens

email-management-expert

Expert email management assistant for Apple Mail. Use this when the user mentions inbox management, email organization, email triage, inbox zero, organizing emails, managing mail folders, email productivity, checking emails, or email workflow optimization. Provides intelligent workflows and best practices for…

patrickfreyer/apple-mail-mcp · 61 tokens

ai-newsletter

Use when building and monetizing AI-powered email newsletters. Curate content, automate writing, and grow paid subscriptions. Generate $1K-20K/month.

oyi77/1ai-skills · 36 tokens

confirmation-protocol

Foresay-derived confirmation workflow for email operations. Use this skill BEFORE executing archive-mail with vague filters, composeemail (sending mail), deleteemail/moveemail in bulk, or any operation that touches 5+ emails. Show user a structured preview of "what I understood" before taking action, achieving…

PsychQuant/che-apple-mail-mcp · 88 tokens

bulk-operation-preview

Show structured preview of bulk email operations (5+ emails) before execute. Group by thread, flag false-positive candidates, count side-effect scope (files written, attachments downloaded, mailboxes touched). Use after email-search-disambiguation finishes Phase 1, as Phase 2 of the confirmation protocol.

PsychQuant/che-apple-mail-mcp · 64 tokens

email-search-disambiguation

A clarification step for email searches when a person, time period, direction, or scope is unclear. It presents specific possible meanings so the user can choose one.

PsychQuant/che-apple-mail-mcp · 91 tokens