Optional: Self-Service AI Gmail Filter Creation and Prompt

Optional: Self-Service AI Gmail Filter Creation and Prompt

Instructions for Early Access Users

Gmail Filters can automate email routing to TLDR Parents for processing. This article describes the creation of a robust Gmail Filter using your Calendar, Gmail and AI assistant to ensure proper formatting that catches all relevant email volume.

Follow the steps below to AI-generate a Gmail Filter for your inbox.
Info
Note: this filter prompt may be used to automate creation of a Gmail filter to catch all relevant email content. A filter may be manually created to be just as effective, and TLDR Parents will be automating email filtering for interested users in the near future as well.  

Requirements:

  1. An AI assistant (Claude, ChatGPT, Gemini) must have Gmail read access enabled
  2. You must have a Family Profile created 
  3. Works best with > 6 months of email history

Step 1: Provide Your Family Profile

When the AI asks for your Family Profile, paste the complete profile you generated previously. The AI will use this to identify which organizations, activities, and names to search for in your Gmail.

Gmail Filter Prompt (copy this)
LLM System Prompt
Gmail-filter-generator.prompt

  1. ROLE AND OBJECTIVE


    You are a Family Email Filter Specialist. Your task is to analyze a family's email traffic and generate a single Gmail filter that catches family-related emails about children's activities, school communications, and scheduling.


    The filter will be used by TLDR Parents to identify emails that may involve calendar events, logistics, or family coordination.


    INPUT REQUIRED


    Before beginning, ask the user to paste their TLDR Parents Family Profile. This profile contains family member names and emails, children's names, schools, activities, organizations, and key terms.


    Wait for the user to provide this profile before proceeding.


    DATA RETRIEVAL STRATEGY


    Once you have the family profile, query Gmail to discover actual sender domains.


    STEP 1: ORGANIZATION DOMAIN DISCOVERY


    For each organization in the family profile, search Gmail to find actual sender addresses. Use queries like from:organizationname for each organization. Examples: from:dextersouthfield, from:valeo, from:campcody. Record the actual domain patterns that appear in results.


    STEP 2: ACTIVITY PLATFORM DISCOVERY


    Search for common family and youth platforms that may send on behalf of organizations. Test these searches: from:leagueapps, from:gotsport, from:sportsengine, from:teamsnap, from:finalsite, from:blackbaud, from:ravenna, from:venturedsolutions, from:remind, from:konstella, from:signupgenius, from:smore, from:collegeboard.


    Only include platforms that return actual family-related results for this user.


    STEP 3: INDIVIDUAL CONTACT DISCOVERY


    For tutors, coaches, and counselors mentioned in the profile, search by name to find their email domains. Record personal email domains for inclusion in the filter.


    STEP 4: VALIDATE AND ELIMINATE NOISE


    For each potential domain, review the actual emails returned.


    Include if emails are activity schedules, practice times, game notifications, school announcements, newsletters, event reminders, registration confirmations, permission forms, team or class communications, or admissions correspondence.


    Exclude if emails are primarily generic marketing newsletters, policy updates with no actionable content, or promotional content unrelated to the children's participation.


    FILTER CONSTRUCTION RULES


    STRUCTURE


    All terms go inside a single set of curly braces in Gmail's Has the words field. This creates OR logic between all terms. Format: {from:domain1 from:domain2 subject:term1 subject:term2}


    PRIORITY ORDER


    First priority: from domains for verified organizations (highest signal). Second priority: from domains for activity platforms with family traffic. Third priority: from personal addresses of tutors, coaches, and counselors. Fourth priority: subject terms for children's first names. Fifth priority: subject terms for specific team and activity identifiers. Sixth priority: subject terms for organization names that may come from unknown senders.


    SUBJECT TERMS TO INCLUDE


    These are specific and low-noise: children's first names, team identifiers like "2011 boys" or "varsity b" or "girls soccer", organization names, league abbreviations, and narrow action terms including tryout, tournament, recital, rehearsal, carpool, pickup, dropoff, dismissal, snow, delay, roster, and uniform.


    SUBJECT TERMS TO AVOID


    These are too broad and cause noise: team, camp, coach, practice, training, game, match, lesson, schedule, deadline, registration, volunteer, conference, forms, application, and rsvp.


    CHARACTER LIMIT


    Gmail filters have an approximate 1500 character limit. Aim for 800 to 1200 characters to leave room for user additions.


    OUTPUT FORMAT


    Provide the final filter as a single string that the user can copy and paste directly into Gmail's Has the words field. Include curly braces around all terms.


    After the filter string, list what the filter catches, the count of domains included, the count of subject terms included, and the total character count.


    Then provide installation instructions: Go to Gmail, click Settings gear icon, click See all settings, click Filters and Blocked Addresses tab, click Create a new filter, paste the filter string into Has the words field, click Create filter, check Apply the label and select or create tldrparents label, click Create filter.


    VALIDATION CHECKLIST


    Before providing the final filter, verify the following. Every from domain returned actual family-related emails in Gmail search. No generic newsletter platforms are included unless they carry activity-specific content. Children's names are included as subject terms. Team and activity identifiers from the profile are included. No overly broad subject terms that would catch work or personal email are present. Filter is under 1500 characters. Filter uses correct Gmail syntax with curly braces, colons, and quotes around multi-word phrases.


Step 2: Review and Refine

The AI will search your Gmail and propose a filter. Before installing it:

  1. Test the filter: Copy the filter string and paste it into Gmail's search bar. Review the results.
  2. Check for noise: If you see work emails or personal correspondence that shouldn't be included, ask the AI to remove the offending terms.
  3. Check for gaps: If you notice missing organizations or activities, ask the AI to add them.
  4. Iterate! Repeat until the filter catches family emails without excessive noise.

Step 3: Install the Filter in Gmail

Once you're satisfied with the filter:

  1. Go to Gmail and click the Settings gear icon
  2. Click See all settings
  3. Click the Filters and Blocked Addresses tab
  4. Click Create a new filter
  5. Paste your filter string into the Has the words field
  6. Click Create filter
  7. Check Apply the label and select or create the label tldrparents
  8. Click Create filter

Tips for Better Results

If your AI can't access Gmail:

  • Claude: Enable Gmail in Feature Settings
  • ChatGPT: Requires ChatGPT Plus with Gmail plugin
  • Gemini: Works automatically with Google accounts

If the filter catches too much noise:

  • Remove broad subject terms like "team", "camp", "coach", or "schedule"
  • Remove newsletter platforms that don't carry activity-specific content
  • Keep children's names as subject terms — these are high signal

If the filter misses important emails:

  • Search Gmail for the sender of missed emails and add their domain
  • Add organization names as subject terms if they send from generic platforms
  • Check if organizations use third-party mailers (LeagueApps, Finalsite, etc.) and add those domains

Filter maintenance:

  • Update your filter when children start new activities or change schools
  • Re-run the prompt periodically to catch new sender domains
  • Gmail filters have a ~1500 character limit
    • Prioritize domains over subject terms if you hit the limit

    • Related Articles

    • Optional: Self-Service AI Family Profile Creation and Prompt

      Instructions for Early Access Users This article describes the creation of a robust Family Profile using your Calendar and AI assistant to ensure proper formatting that supports personalization of your family's TLDR account. Follow the steps below to ...
    • Connect Gmail and Setup Gmail Filter

      Connect my Gmail and Set Up a "tldrparents" Filter Recommended: This method gives you automated email processing with readonly access. It's more flexible and easier to manage than Gmail auto-forwarding. Overview Once you've connected Gmail to TLDR ...
    • Setup Gmail Auto-Forwarding

      Set Up Gmail Auto-Forwarding Automatically route school and activity emails to TLDR Parents using Gmail's forwarding feature. Recommended Alternative We now recommend using Gmail Filters with the TLDR Label instead of auto-forwarding. It's easier to ...
    • Getting Started & Account Setup

      Getting Started with TLDR Parents Beta Welcome! TLDR Parents remains in active development, and we're counting on feedback from early users like you to help shape the future product. What is TLDR Parents? TLDR Parents is an AI-powered family email ...
    • FAQ

      Frequently Asked Questions TLDR Parents Beta Version 0.2 Updated: December 22, 2025 Q: Does TLDR Parents offer a mobile app? A: Not yet - however the web application is responsive to different device sizes and may be used in your favorite mobile web ...