airmail-mcp 1.0.2 → 1.0.4
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 +61 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Airmail MCP
|
|
2
2
|
|
|
3
|
-
MCP server for [Airmail](https://airmailapp.com) — manage emails, calendars, contacts, and more from
|
|
3
|
+
MCP server for [Airmail](https://airmailapp.com) — manage emails, calendars, contacts, and more from AI assistants.
|
|
4
4
|
|
|
5
|
-
This is a lightweight bridge that connects
|
|
5
|
+
This is a lightweight bridge that connects AI clients to Airmail's built-in MCP server. The bridge connects locally to Airmail on your Mac. Data retrieved by AI tools is processed by your chosen AI provider.
|
|
6
6
|
|
|
7
7
|
## Requirements
|
|
8
8
|
|
|
@@ -50,7 +50,64 @@ The auth token is read automatically from the macOS Keychain. If you set `AIRMAI
|
|
|
50
50
|
### Claude Code
|
|
51
51
|
|
|
52
52
|
```bash
|
|
53
|
-
claude mcp add --transport stdio airmail -- npx -y airmail-mcp
|
|
53
|
+
claude mcp remove airmail && claude mcp add --transport stdio airmail -- npx -y airmail-mcp
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Gemini CLI
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
gemini mcp remove airmail && gemini mcp add airmail npx -- -y airmail-mcp
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Codex CLI
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
codex mcp remove airmail && codex mcp add airmail -- npx -y airmail-mcp
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Cursor
|
|
69
|
+
|
|
70
|
+
Add to `.cursor/mcp.json` in your project (or global settings):
|
|
71
|
+
|
|
72
|
+
```json
|
|
73
|
+
{
|
|
74
|
+
"mcpServers": {
|
|
75
|
+
"airmail": {
|
|
76
|
+
"command": "npx",
|
|
77
|
+
"args": ["-y", "airmail-mcp"]
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Windsurf
|
|
84
|
+
|
|
85
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
86
|
+
|
|
87
|
+
```json
|
|
88
|
+
{
|
|
89
|
+
"mcpServers": {
|
|
90
|
+
"airmail": {
|
|
91
|
+
"command": "npx",
|
|
92
|
+
"args": ["-y", "airmail-mcp"]
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### VS Code (GitHub Copilot)
|
|
99
|
+
|
|
100
|
+
Add to `.vscode/mcp.json` in your project:
|
|
101
|
+
|
|
102
|
+
```json
|
|
103
|
+
{
|
|
104
|
+
"servers": {
|
|
105
|
+
"airmail": {
|
|
106
|
+
"command": "npx",
|
|
107
|
+
"args": ["-y", "airmail-mcp"]
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
54
111
|
```
|
|
55
112
|
|
|
56
113
|
## Authentication
|
|
@@ -112,7 +169,7 @@ To find your token: open Airmail → **Preferences → MCP** → copy the **Auth
|
|
|
112
169
|
## How it works
|
|
113
170
|
|
|
114
171
|
```
|
|
115
|
-
|
|
172
|
+
AI Client ←stdio→ airmail-mcp (Node.js) ←HTTP→ Airmail.app (localhost:9876)
|
|
116
173
|
```
|
|
117
174
|
|
|
118
175
|
This package is a thin transport bridge. All tool logic runs inside Airmail's native Swift MCP server. The bridge:
|
package/package.json
CHANGED