kdeps.io (alpha) - npm for AI agents<br>Alphakdeps.io is experimental and evolving — the registry and packages may change or reset.<br>Sign in

kdeps-ai-email-client<br>workflowv1.0.0<br>AI email client — triage, summarize, draft, reorganize labels, and unsubscribe, with a web UI

Install<br>kdeps registry install kdeps-ai-email-client<br>Then run locally:<br>kdeps exec kdeps-ai-email-client<br>Configure LLM provider in ~/.kdeps/config.yaml (created automatically on first run).

README<br>ai-email-client

An AI email client as a kdeps workflow: triage, summarize, draft, reorganize<br>labels, and unsubscribe — with a single-page web UI. IMAP/SMTP for mail, an LLM<br>(DeepSeek by default) for the intelligence.

One API route (POST /api/v1/mail) dispatches on an action field; the browser<br>UI is served on the same port.

Actions

actionwhat it doesinboxFetch the inbox over IMAP and triage each email (category, priority, summary, folder). Per-email cache — only new mail hits the LLM.reorganizePropose a destination folder per email (reusing your real IMAP folders).applyMove the selected emails into their folders (auto-creates missing folders, case-insensitive match).labelsAI plan to consolidate duplicate/near-duplicate folders (merge + delete).labelsApplyExecute the label plan: move mail from redundant folders into canonical ones, then delete the emptied ones.protectSet a protected-labels list that label cleanup never merges away or deletes.summarizeSummarize one email.draftDraft a reply in a chosen tone.sendSend a drafted reply over SMTP.unsubscribeList senders with a List-Unsubscribe header (RFC 2369/8058).unsubApplyUnsubscribe from the selected senders (one-click POST or GET).<br>Configure

Credentials live in ~/.kdeps/config.yaml (never in the workflow):

llm:<br>backend: deepseek<br>deepseek_api_key: sk-...<br>smtp_connections:<br>default: { host: smtp.gmail.com, port: 587, username: you@gmail.com, password: app-password, tls: true }<br>imap_connections:<br>inbox: { host: imap.gmail.com, port: 993, username: you@gmail.com, password: app-password, tls: true }

Gmail: use an App Password, not your login password.

Run

export KDEPS_API_AUTH_TOKEN=dev-token # required whenever apiServer is set<br>kdeps run . # API + web UI on http://127.0.0.1:16395

Open http://127.0.0.1:16395/, paste the bearer token, and use the unified view:<br>per-email Original / Summarize / Draft / Unsub plus folder Move , with<br>Reorganize , Label cleanup , and Find subscriptions in the toolbar.

Notes

Actions that change your mailbox (move, label cleanup, unsubscribe, send) are<br>always preview-then-confirm — the LLM never mutates mail on its own.

The Original view renders HTML in a sandboxed iframe with a strict CSP;<br>remote images are blocked until you toggle "Load remote images".

License: Apache-2.0

Versions<br>VersionPublishedStatus1.0.07/19/2026active

Details<br>Authorkdeps<br>LicenseApache-2.0<br>Latest Version1.0.0<br>Published7/19/2026

Links<br>Homepage<br>Tags<br>llmemailapiwebagent

Links

© 2026 Kdeps, KvK 94834768. Licensed under Apache 2.0.