Discord

seed/tools/email-db/TOOL.md

@@ -2,7 +2,7 @@
 version: 3
 name: email_db
 label: Email Database
-description: Query, search, aggregate, and manage the user's email database. Use this tool to answer questions about emails, find messages by sender/domain/date/content, get statistics, and delete emails. The database is a local SQLite copy of the user's synced Gmail inbox.
+description: Query, search, aggregate, and manage the user's email database. Use this tool to answer questions about emails, find messages by sender/domain/date/content, get statistics, and delete emails. The database is a local SQLite copy of the user's synced Gmail. All actions default to inbox scope — use folder parameter to query other folders like sent, spam, trash, or 'all' for everything.
 language: typescript
 inputs:
   action:
@@ -36,6 +36,10 @@ inputs:
     type: string
     description: "Attachment content type filter. Full MIME type (e.g. 'image/jpeg') or just the type prefix (e.g. 'image' matches all image types). Used with 'attachments' action."
     optional: true
+  folder:
+    type: string
+    description: "Gmail folder/label to scope results. Defaults to 'inbox'. Use 'all' for all folders. Common values: inbox, sent, spam, trash."
+    optional: true
   limit:
     type: number
     description: "Maximum number of results to return (default 20, max 100)."
@@ -65,9 +69,9 @@ emails (
   id TEXT PRIMARY KEY,
   integration TEXT,      -- source: 'gmail', 'outlook', etc.
   email_account TEXT,    -- which account: 'user@gmail.com'
-  from_name TEXT,
-  from_address TEXT,
-  from_domain TEXT,
+  from_name TEXT,        -- sender display name
+  from_address TEXT,     -- sender email (lowercase)
+  from_domain TEXT,      -- domain extracted from sender
   to_address TEXT,
   cc TEXT,
   subject TEXT,
@@ -77,7 +81,8 @@ emails (
   text_body TEXT,
   attachment_count INTEGER,
   read INTEGER,
-  deleted INTEGER
+  deleted INTEGER,
+  labels TEXT            -- comma-separated label list (e.g. 'INBOX,UNREAD,CATEGORY_UPDATES')
 )
 
 attachments (
@@ -91,10 +96,13 @@ attachments (
 
 ## Examples
 
-- Search for invoices: `action: "search", search: "invoice"`
+- Search for invoices (inbox only): `action: "search", search: "invoice"`
+- Search sent emails for invoices: `action: "search", search: "invoice", folder: "sent"`
+- Search all folders: `action: "search", search: "invoice", folder: "all"`
 - Count emails from a domain: `action: "count", domain: "newsletter.com"`
 - Delete all emails from a domain: `action: "delete", domain: "spam.com"`
 - Top 10 domains: `action: "domains", limit: 10`
+- Stats for spam folder: `action: "stats", folder: "spam"`
 - List attachment types: `action: "attachment-types"`
 - Find image attachments: `action: "attachments", content_type: "image"`
 - Find PDFs from a sender: `action: "attachments", content_type: "application/pdf", sender: "boss@company.com"`