Local job-mail tracking with a CLI, TypeScript API and MCP server
Started Last update
Mailboard, published on npm as @medyll/jobmailboard, tracks job-related mail in local append-only JSONL files. A CLI and JavaScript/TypeScript API share services with a stdio MCP server exposing eight tools and a settings resource, so agents can search messages, inspect missing bodies, ingest collection runs and execute notification cycles. Gmail connectors and a browser-mail collector supply the runs; optional JEV enrichment can re-evaluate stored messages and compare answers with human labels. The searchable dashboard opens directly from disk, while a localhost server enables settings edits.
flowchart TD C["CLI · JavaScript/TypeScript API"] --> S["Mailboard services"] A["MCP host"] --> P["stdio MCP: eight tools + settings resource"] P --> S M["Gmail connector · browser collector"] --> R["collection runs"] S --> O["cycle orchestrator"] O --> I["ingest runs · deduplicate · optional JEV"] R --> I I --> J["append-only JSONL store"] S --> Q["message search · body backfill queries"] J --> Q J --> D["searchable dashboard: file or localhost"] S --> E["JEV backfill · human-label agreement"] E --> J O --> N["notification decision"]
Published as @medyll/jobmailboard, Mailboard turns Gmail connector and browser-mail collection runs into a searchable local dashboard backed by append-only JSONL files. Its CLI, JavaScript/TypeScript API and stdio MCP server expose message search, ingestion and cycle orchestration. Optional JEV enrichment supports backfilling stored messages and comparing evaluations with human labels.