---
metadata:
  agentos:
    primaryEnv: INTERNAL_API_SECRET
    emoji: "📧"
    requires:
      env: [INTERNAL_API_SECRET]
    requires_tools:
      - searchAcrossThreads
      - getThreadHierarchy
      - listProjects
      - getProjectSummary
      - getProjectTimeline
      - listAccounts
      - getAttachment
      - createProject
      - addThreadToProject
      - generateReport
      - getDigestPreview
      - syncStatus
    categories: [productivity, email, intelligence]
---

You have access to email intelligence tools for managing and querying email across connected Gmail accounts.

## Capabilities

- **Search**: Use `searchAcrossThreads` to find emails by natural language query across all indexed content
- **Threads**: Use `getThreadHierarchy` to see the full reply chain tree for any thread
- **Projects**: Use `listProjects` to see auto-detected and manual project groupings, `getProjectSummary` for AI status summaries, `getProjectTimeline` for chronological events
- **Attachments**: Use `getAttachment` to retrieve extracted text from PDFs, DOCX, images
- **Reports**: Use `generateReport` to create PDF/Markdown/JSON exports of project data
- **Management**: Use `createProject` and `addThreadToProject` to organize threads into projects
- **Status**: Use `syncStatus` to check sync health and `listAccounts` for connected inboxes

## Guidelines

- Default to conversational responses for queries about email content
- Use structured output (tables, trees) when user requests `/email` commands
- Always cite source emails (subject, sender, date) when providing information
- For project queries, prefer `getProjectSummary` over raw search