@n24q02m/better-email-mcp 1.18.0 → 1.19.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 +5 -63
- package/bin/cli.mjs +45 -45
- package/build/src/auth/per-user-credential-store.d.ts.map +1 -1
- package/build/src/auth/per-user-credential-store.js +19 -14
- package/build/src/auth/per-user-credential-store.js.map +1 -1
- package/build/src/transports/http.d.ts.map +1 -1
- package/build/src/transports/http.js +16 -13
- package/build/src/transports/http.js.map +1 -1
- package/build/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -31,72 +31,14 @@ mcp-name: io.github.n24q02m/better-email-mcp
|
|
|
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
|
|
33
33
|
|
|
34
|
-
##
|
|
34
|
+
## Setup
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
**With AI Agent** -- copy and send this to your AI agent:
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
> Please set up @n24q02m/better-email-mcp for me. Follow this guide:
|
|
39
|
+
> https://raw.githubusercontent.com/n24q02m/better-email-mcp/main/docs/setup-with-agent.md
|
|
39
40
|
|
|
40
|
-
|
|
41
|
-
/plugin marketplace add n24q02m/claude-plugins
|
|
42
|
-
/plugin install better-email-mcp@n24q02m-plugins
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
Set credentials in `~/.claude/settings.local.json` or shell profile. See [Prerequisites](#mcp-server).
|
|
48
|
-
|
|
49
|
-
### Codex CLI
|
|
50
|
-
|
|
51
|
-
Add to `~/.codex/config.toml`:
|
|
52
|
-
|
|
53
|
-
```toml
|
|
54
|
-
[mcp_servers.better-email-mcp]
|
|
55
|
-
command = "npx"
|
|
56
|
-
args = ["-y", "@n24q02m/better-email-mcp"]
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### MCP Server
|
|
60
|
-
|
|
61
|
-
**Prerequisites:** Create App Passwords (NOT your regular password):
|
|
62
|
-
- **Gmail**: Enable 2FA, then <https://myaccount.google.com/apppasswords>
|
|
63
|
-
- **Yahoo**: Enable 2FA, then <https://login.yahoo.com/account/security/app-passwords>
|
|
64
|
-
- **iCloud**: <https://appleid.apple.com> > Sign-In and Security > App-Specific Passwords
|
|
65
|
-
- **Outlook/Hotmail/Live**: OAuth2 built-in (server guides you on first use)
|
|
66
|
-
|
|
67
|
-
#### Option 1: npx
|
|
68
|
-
|
|
69
|
-
```jsonc
|
|
70
|
-
{
|
|
71
|
-
"mcpServers": {
|
|
72
|
-
"better-email": {
|
|
73
|
-
"command": "npx",
|
|
74
|
-
"args": ["-y", "@n24q02m/better-email-mcp@latest"]
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
}
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
Other runners: `bun x`, `pnpm dlx`, `yarn dlx` also work.
|
|
81
|
-
|
|
82
|
-
#### Option 2: Docker
|
|
83
|
-
|
|
84
|
-
```jsonc
|
|
85
|
-
{
|
|
86
|
-
"mcpServers": {
|
|
87
|
-
"better-email": {
|
|
88
|
-
"command": "docker",
|
|
89
|
-
"args": [
|
|
90
|
-
"run", "-i", "--rm",
|
|
91
|
-
"-e", "EMAIL_CREDENTIALS",
|
|
92
|
-
"n24q02m/better-email-mcp:latest"
|
|
93
|
-
]
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
Configure `EMAIL_CREDENTIALS` in `~/.claude/settings.local.json` or your shell profile. See [Environment Variables](#environment-variables) below.
|
|
41
|
+
**Manual Setup** -- follow [docs/setup-manual.md](docs/setup-manual.md)
|
|
100
42
|
|
|
101
43
|
## Tools
|
|
102
44
|
|