@n24q02m/better-email-mcp 1.7.0 → 1.8.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.
- package/README.md +4 -20
- package/bin/cli.mjs +45 -42
- package/build/src/docs/send.md +2 -17
- package/build/src/init-server.js +1 -1
- package/build/src/init-server.js.map +1 -1
- package/build/src/tools/helpers/config.d.ts.map +1 -1
- package/build/src/tools/helpers/config.js +3 -5
- package/build/src/tools/helpers/config.js.map +1 -1
- package/build/src/tools/helpers/oauth2.d.ts +20 -3
- package/build/src/tools/helpers/oauth2.d.ts.map +1 -1
- package/build/src/tools/helpers/oauth2.js +113 -27
- package/build/src/tools/helpers/oauth2.js.map +1 -1
- package/build/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -43,7 +43,7 @@ Create App Passwords (NOT your regular password):
|
|
|
43
43
|
- **Gmail**: Enable 2FA, then <https://myaccount.google.com/apppasswords>
|
|
44
44
|
- **Yahoo**: Enable 2FA, then <https://login.yahoo.com/account/security/app-passwords>
|
|
45
45
|
- **iCloud**: <https://appleid.apple.com> > Sign-In and Security > App-Specific Passwords
|
|
46
|
-
- **Outlook**: OAuth2
|
|
46
|
+
- **Outlook/Hotmail/Live**: OAuth2 built-in (server guides you on first use)
|
|
47
47
|
|
|
48
48
|
### Option 1: Package Manager (Recommended)
|
|
49
49
|
|
|
@@ -165,27 +165,11 @@ EMAIL_CREDENTIALS=user@custom.com:password:imap.custom.com
|
|
|
165
165
|
| ProtonMail | ProtonMail Bridge | `imap.protonmail.ch:993` / TLS (465) | IMAP APPEND |
|
|
166
166
|
| Custom | Via `email:pass:imap.host` format | Configurable | IMAP APPEND |
|
|
167
167
|
|
|
168
|
-
### Outlook OAuth2
|
|
168
|
+
### Outlook OAuth2
|
|
169
169
|
|
|
170
|
-
Outlook.com / Hotmail / Live accounts
|
|
170
|
+
Outlook.com / Hotmail / Live accounts use OAuth2 automatically — just add the email to `EMAIL_CREDENTIALS`. On first use, the server returns a sign-in link and code. Open the link, enter the code, then retry your request. Tokens are saved to `~/.better-email-mcp/tokens.json` and auto-refresh silently.
|
|
171
171
|
|
|
172
|
-
**
|
|
173
|
-
```bash
|
|
174
|
-
OUTLOOK_CLIENT_ID=your-azure-app-id npx @n24q02m/better-email-mcp auth user@outlook.com
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
**Step 2:** Use as normal — OAuth2 is automatic:
|
|
178
|
-
```bash
|
|
179
|
-
EMAIL_CREDENTIALS=user@outlook.com:anything
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
Tokens are saved to `~/.better-email-mcp/tokens.json` and auto-refresh silently.
|
|
183
|
-
|
|
184
|
-
> **For server operators:** Register a public client app at [Azure Portal](https://portal.azure.com) > App registrations:
|
|
185
|
-
> 1. **Supported account types**: "Accounts in any organizational directory and personal Microsoft accounts"
|
|
186
|
-
> 2. **Authentication** > **Advanced settings**: Enable "Allow public client flows"
|
|
187
|
-
> 3. **API permissions** > Add permissions > Microsoft Graph > Delegated: `IMAP.AccessAsUser.All`, `SMTP.Send`
|
|
188
|
-
> 4. Set `OUTLOOK_CLIENT_ID` to the Application (client) ID
|
|
172
|
+
> **Self-hosting with your own client ID?** Set `OUTLOOK_CLIENT_ID` env var. See [Azure Setup](src/docs/send.md#outlook-oauth2) for details.
|
|
189
173
|
|
|
190
174
|
---
|
|
191
175
|
|