@n24q02m/better-email-mcp 1.20.0 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +3 -2
  2. package/bin/cli.mjs +636 -420
  3. package/build/src/credential-form.d.ts +37 -0
  4. package/build/src/credential-form.d.ts.map +1 -0
  5. package/build/src/credential-form.js +595 -0
  6. package/build/src/credential-form.js.map +1 -0
  7. package/build/src/credential-state.d.ts +2 -0
  8. package/build/src/credential-state.d.ts.map +1 -1
  9. package/build/src/credential-state.js +49 -20
  10. package/build/src/credential-state.js.map +1 -1
  11. package/build/src/docs/setup.md +42 -0
  12. package/build/src/init-server.d.ts.map +1 -1
  13. package/build/src/init-server.js +9 -8
  14. package/build/src/init-server.js.map +1 -1
  15. package/build/src/relay-schema.d.ts +1 -1
  16. package/build/src/relay-schema.d.ts.map +1 -1
  17. package/build/src/relay-schema.js +1 -1
  18. package/build/src/relay-schema.js.map +1 -1
  19. package/build/src/relay-setup.js +3 -3
  20. package/build/src/relay-setup.js.map +1 -1
  21. package/build/src/tools/composite/setup.d.ts +39 -0
  22. package/build/src/tools/composite/setup.d.ts.map +1 -0
  23. package/build/src/tools/composite/setup.js +60 -0
  24. package/build/src/tools/composite/setup.js.map +1 -0
  25. package/build/src/tools/helpers/oauth2.d.ts +18 -0
  26. package/build/src/tools/helpers/oauth2.d.ts.map +1 -1
  27. package/build/src/tools/helpers/oauth2.js +69 -1
  28. package/build/src/tools/helpers/oauth2.js.map +1 -1
  29. package/build/src/tools/helpers/security.js +1 -1
  30. package/build/src/tools/helpers/security.js.map +1 -1
  31. package/build/src/tools/registry.d.ts +3 -3
  32. package/build/src/tools/registry.d.ts.map +1 -1
  33. package/build/src/tools/registry.js +47 -9
  34. package/build/src/tools/registry.js.map +1 -1
  35. package/build/src/transports/http.d.ts +21 -11
  36. package/build/src/transports/http.d.ts.map +1 -1
  37. package/build/src/transports/http.js +171 -345
  38. package/build/src/transports/http.js.map +1 -1
  39. package/build/tsconfig.build.tsbuildinfo +1 -1
  40. package/package.json +10 -13
  41. package/build/src/auth/email-auth-provider.d.ts +0 -76
  42. package/build/src/auth/email-auth-provider.d.ts.map +0 -1
  43. package/build/src/auth/email-auth-provider.js +0 -235
  44. package/build/src/auth/email-auth-provider.js.map +0 -1
  45. package/build/src/auth/per-user-credential-store.d.ts +0 -44
  46. package/build/src/auth/per-user-credential-store.d.ts.map +0 -1
  47. package/build/src/auth/per-user-credential-store.js +0 -155
  48. package/build/src/auth/per-user-credential-store.js.map +0 -1
  49. package/build/src/auth/stateless-client-store.d.ts +0 -27
  50. package/build/src/auth/stateless-client-store.d.ts.map +0 -1
  51. package/build/src/auth/stateless-client-store.js +0 -61
  52. package/build/src/auth/stateless-client-store.js.map +0 -1
  53. package/build/src/transports/credential-store.d.ts +0 -17
  54. package/build/src/transports/credential-store.d.ts.map +0 -1
  55. package/build/src/transports/credential-store.js +0 -64
  56. package/build/src/transports/credential-store.js.map +0 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  mcp-name: io.github.n24q02m/better-email-mcp
4
4
 
5
- **IMAP/SMTP email server for AI agents -- 5 composite tools with multi-account and auto-discovery**
5
+ **IMAP/SMTP email server for AI agents -- 6 composite tools with multi-account and auto-discovery**
6
6
 
7
7
  <!-- Badge Row 1: Status -->
8
8
  [![CI](https://github.com/n24q02m/better-email-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/n24q02m/better-email-mcp/actions/workflows/ci.yml)
@@ -26,7 +26,7 @@ mcp-name: io.github.n24q02m/better-email-mcp
26
26
 
27
27
  - **Multi-account support** -- manage 6+ email accounts (Gmail, Outlook, Yahoo, iCloud, Zoho, ProtonMail, custom IMAP)
28
28
  - **App Passwords** -- no OAuth2 setup required for most providers; clone and run in 1 minute
29
- - **5 composite tools** with 15 actions -- search, read, send, reply, forward, organize in single calls
29
+ - **6 composite tools** with 20 actions -- search, read, send, reply, forward, organize, credential setup in single calls
30
30
  - **Auto-discovery** -- provider settings detected from email address, custom IMAP host supported
31
31
  - **Thread-aware** -- reply/forward maintains In-Reply-To and References headers
32
32
  - **Tiered token optimization** -- compressed descriptions + on-demand `help` tool + MCP Resources
@@ -48,6 +48,7 @@ mcp-name: io.github.n24q02m/better-email-mcp
48
48
  | `folders` | `list` | List mailbox folders |
49
49
  | `attachments` | `list`, `download` | List and download email attachments |
50
50
  | `send` | `new`, `reply`, `forward` | Compose, reply, and forward emails |
51
+ | `setup` | `status`, `start`, `reset`, `complete` | Credential setup via browser relay, status check, reset, re-resolve |
51
52
  | `help` | - | Get full documentation for any tool |
52
53
 
53
54
  ### MCP Resources