gogcli-mcp-gmail 2.21.0 → 2.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 (8) hide show
  1. package/README.md +26 -4
  2. package/SKILL.md +24 -3
  3. package/dist/index.js +522 -75
  4. package/manifest.json +6 -2
  5. package/package.json +1 -1
  6. package/src/tools/gmail-extra.ts +201 -29
  7. package/tests/tools/attachment-index-resolve.test.ts +76 -0
  8. package/tests/tools/gmail-extra.test.ts +382 -46
package/README.md CHANGED
@@ -44,18 +44,19 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
44
44
  claude mcp add gogcli-gmail -- gogcli-mcp-gmail
45
45
  ```
46
46
 
47
- ## Extra Gmail Tools (23)
47
+ ## Extra Gmail Tools (45)
48
48
 
49
- Plus 5 auth tools and 4 base Gmail tools (search, get, send, run).
49
+ Plus 8 auth tools and 4 base Gmail tools (search, get, send, run) — 57 in all.
50
50
 
51
51
  ### Read
52
52
 
53
53
  | Tool | Description |
54
54
  |------|-------------|
55
55
  | `gog_gmail_raw` | Dump the raw Gmail API JSON for a message (lossless, for scripting) |
56
- | `gog_gmail_attachment` | Download an attachment and deliver its contents — inline (base64 image/resource) when ≤3 MiB, otherwise uploaded to Google Drive with a shareable link (`deliver`: auto/inline/drive/off) |
56
+ | `gog_gmail_attachment` | Download an attachment (by `attachmentIndex`, or the legacy opaque `attachmentId`) and deliver its contents — inline (base64 image/resource) when within the inline limit (3 MiB by default, `inlineMaxBytes`), otherwise uploaded to Google Drive with a shareable link (`deliver`: auto/inline/drive/off) |
57
57
  | `gog_gmail_url` | Print Gmail web URLs for one or more threads |
58
58
  | `gog_gmail_history` | List Gmail history events since a given historyId |
59
+ | `gog_gmail_messages_search` | Search individual messages rather than threads — one result per matching message |
59
60
 
60
61
  ### Threads
61
62
 
@@ -75,6 +76,7 @@ Plus 5 auth tools and 4 base Gmail tools (search, get, send, run).
75
76
  | `gog_gmail_labels_rename` | Rename a label |
76
77
  | `gog_gmail_labels_delete` | Delete a label |
77
78
  | `gog_gmail_labels_modify` | Modify labels on one or more threads |
79
+ | `gog_gmail_labels_style` | Change a user label's color or visibility |
78
80
 
79
81
  ### Bulk Operations
80
82
 
@@ -103,10 +105,30 @@ Plus 5 auth tools and 4 base Gmail tools (search, get, send, run).
103
105
 
104
106
  | Tool | Description |
105
107
  |------|-------------|
108
+ | `gog_gmail_import` | Import an RFC822/EML message into the mailbox, keeping its original headers and date (does not send) |
106
109
  | `gog_gmail_forward` | Forward a message to new recipients (with optional note) |
110
+ | `gog_gmail_reply` | Reply to a message (original sender only) |
111
+ | `gog_gmail_reply_all` | Reply to every participant (sender plus all To/Cc recipients) |
107
112
  | `gog_gmail_autoreply` | Reply once to all messages matching a query (with dedupe label) |
108
113
 
109
- Track and admin settings (`track`, `settings filters`, `delegates`, `forwarding`, `sendas`, `vacation`, `watch`) are available via the base `gog_gmail_run` escape hatch.
114
+ ### Settings
115
+
116
+ | Tool | Description |
117
+ |------|-------------|
118
+ | `gog_gmail_vacation_get` | Get the vacation responder (auto-reply) settings |
119
+ | `gog_gmail_vacation_update` | Enable or disable the vacation responder, with optional start/end and audience limits |
120
+ | `gog_gmail_filters_list` | List all Gmail filters |
121
+ | `gog_gmail_filters_get` | Get a filter's criteria and actions by ID |
122
+ | `gog_gmail_filters_create` | Create a filter from match criteria plus one or more actions |
123
+ | `gog_gmail_filters_delete` | Delete a filter by ID |
124
+ | `gog_gmail_sendas_list` | List all send-as aliases |
125
+ | `gog_gmail_sendas_get` | Get one send-as alias by address |
126
+ | `gog_gmail_sendas_create` | Create a send-as alias (usually needs verification before use) |
127
+ | `gog_gmail_sendas_update` | Update an alias (display name, reply-to, signature, default) |
128
+ | `gog_gmail_sendas_delete` | Delete a send-as alias |
129
+ | `gog_gmail_sendas_verify` | Resend the verification email for a pending alias |
130
+
131
+ Email tracking (`track`) and the remaining admin settings (`delegates`, `forwarding`, `watch`) have no dedicated tool — reach them through the base `gog_gmail_run` escape hatch.
110
132
 
111
133
  ## License
112
134
 
package/SKILL.md CHANGED
@@ -5,7 +5,7 @@ description: Use when the user asks to read, organize, draft, forward, autoreply
5
5
 
6
6
  # gogcli-mcp-gmail
7
7
 
8
- Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 32 tools: auth + 4 base Gmail + 23 extra dedicated Gmail tools.
8
+ Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 57 tools: 8 auth + 4 base Gmail + 45 extra dedicated Gmail tools.
9
9
 
10
10
  - **Source:** [github.com/chrischall/gogcli-mcp](https://github.com/chrischall/gogcli-mcp)
11
11
 
@@ -36,9 +36,10 @@ Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 3
36
36
  | Tool | What it does |
37
37
  |------|-------------|
38
38
  | `gog_gmail_raw` | Raw Gmail API JSON for a message |
39
- | `gog_gmail_attachment` | Download an attachment and deliver its contents — inline when ≤3 MiB, else uploaded to Drive with a link (`deliver`: auto/inline/drive/off) |
39
+ | `gog_gmail_attachment` | Download an attachment by `attachmentIndex` (or legacy `attachmentId`) and deliver its contents — inline when within `inlineMaxBytes` (3 MiB default), else uploaded to Drive with a link (`deliver`: auto/inline/drive/off) |
40
40
  | `gog_gmail_url` | Print web URLs for threads |
41
41
  | `gog_gmail_history` | List history events since a historyId |
42
+ | `gog_gmail_messages_search` | Search individual messages, not threads — one row per message |
42
43
 
43
44
  ### Threads
44
45
  | Tool | What it does |
@@ -56,6 +57,7 @@ Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 3
56
57
  | `gog_gmail_labels_rename` | Rename a label |
57
58
  | `gog_gmail_labels_delete` | Delete a label |
58
59
  | `gog_gmail_labels_modify` | Modify labels on one or more threads |
60
+ | `gog_gmail_labels_style` | Change a label's color or visibility |
59
61
 
60
62
  ### Bulk operations
61
63
  | Tool | What it does |
@@ -81,7 +83,26 @@ Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 3
81
83
  ### Write
82
84
  | Tool | What it does |
83
85
  |------|-------------|
86
+ | `gog_gmail_import` | Import an RFC822/EML message into the mailbox (keeps its headers/date; does not send) |
84
87
  | `gog_gmail_forward` | Forward a message |
88
+ | `gog_gmail_reply` | Reply to the original sender |
89
+ | `gog_gmail_reply_all` | Reply to sender plus every To/Cc recipient |
85
90
  | `gog_gmail_autoreply` | Reply once to all messages matching a query |
86
91
 
87
- Plus 5 auth tools and 4 base Gmail tools (search, get, send, run). Use `gog_gmail_run` for advanced settings (`filters`, `delegates`, `forwarding`, `sendas`, `vacation`, `watch`) and email tracking (`track`).
92
+ ### Settings
93
+ | Tool | What it does |
94
+ |------|-------------|
95
+ | `gog_gmail_vacation_get` | Get the vacation responder settings |
96
+ | `gog_gmail_vacation_update` | Enable/disable the vacation responder |
97
+ | `gog_gmail_filters_list` | List all filters |
98
+ | `gog_gmail_filters_get` | Get a filter by ID |
99
+ | `gog_gmail_filters_create` | Create a filter |
100
+ | `gog_gmail_filters_delete` | Delete a filter |
101
+ | `gog_gmail_sendas_list` | List send-as aliases |
102
+ | `gog_gmail_sendas_get` | Get one send-as alias |
103
+ | `gog_gmail_sendas_create` | Create a send-as alias |
104
+ | `gog_gmail_sendas_update` | Update a send-as alias |
105
+ | `gog_gmail_sendas_delete` | Delete a send-as alias |
106
+ | `gog_gmail_sendas_verify` | Resend an alias verification email |
107
+
108
+ Plus 8 auth tools and 4 base Gmail tools (search, get, send, run). Use `gog_gmail_run` for the settings with no dedicated tool (`delegates`, `forwarding`, `watch`) and email tracking (`track`).