Local job-mail tracking with a CLI, TypeScript API and MCP server
Started Last update
Mailboard collects job-related messages from Gmail connectors, browser mail and Proton Mail Bridge. The Proton collector reads mail over IMAP and feeds the same append-only JSONL store as the other sources. The @medyll/jobmailboard CLI, JavaScript/TypeScript API and stdio MCP server share search, ingestion and notification services. The dashboard opens directly from disk, and optional JEV enrichment can re-evaluate stored messages against human labels.
flowchart TD C["CLI · JavaScript/TypeScript API"] --> S["Mailboard services"] A["MCP host"] --> P["stdio MCP tools + settings resource"] P --> S M["Gmail connector · browser collector"] --> R["collection runs"] B["Proton Mail Bridge · read-only IMAP"] --> R 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"]
Mailboard brings job-related messages from Gmail, browser mail and Proton Mail into a searchable local dashboard backed by append-only JSONL files. Proton collection uses read-only IMAP through Proton Mail Bridge. The @medyll/jobmailboard package exposes message search, ingestion and cycle orchestration through a CLI, a JavaScript/TypeScript API and a stdio MCP server.