gogcli-mcp-contacts 2.0.6
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 +59 -0
- package/SKILL.md +43 -0
- package/dist/index.js +31179 -0
- package/manifest.json +128 -0
- package/package.json +42 -0
- package/src/index.ts +12 -0
- package/src/tools/contacts-extra.ts +79 -0
- package/tests/tools/contacts-extra.test.ts +98 -0
- package/tsconfig.json +9 -0
- package/vitest.config.ts +17 -0
package/README.md
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# gogcli-mcp-contacts
|
|
2
|
+
|
|
3
|
+
> [!WARNING]
|
|
4
|
+
> **AI-developed project.** This codebase was built and is actively maintained by [Claude Code](https://www.anthropic.com/claude). Review all code and tool permissions before use.
|
|
5
|
+
|
|
6
|
+
Extended Google Contacts [MCP](https://modelcontextprotocol.io) server via [gogcli](https://github.com/steipete/gogcli). Includes auth tools plus the base Contacts tools and 5 additional dedicated People API tools for Workspace directory search, profile fields, and relations.
|
|
7
|
+
|
|
8
|
+
## Requirements
|
|
9
|
+
|
|
10
|
+
- [gogcli](https://github.com/steipete/gogcli) installed and authenticated
|
|
11
|
+
- Node.js 18+
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
brew install gogcli
|
|
15
|
+
gog auth add your@gmail.com --services contacts,people
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Installation
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install -g gogcli-mcp-contacts
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Claude Desktop
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"mcpServers": {
|
|
29
|
+
"gogcli-contacts": {
|
|
30
|
+
"command": "gogcli-mcp-contacts",
|
|
31
|
+
"env": {
|
|
32
|
+
"GOG_ACCOUNT": "you@gmail.com"
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Claude Code
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
claude mcp add gogcli-contacts -- gogcli-mcp-contacts
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Extra People Tools (5)
|
|
46
|
+
|
|
47
|
+
Plus 5 auth tools and 5 base Contacts tools (search, list, get, create, run).
|
|
48
|
+
|
|
49
|
+
| Tool | Description |
|
|
50
|
+
|------|-------------|
|
|
51
|
+
| `gog_people_me` | Show your own People profile (people/me) |
|
|
52
|
+
| `gog_people_get` | Get a People profile by resource name |
|
|
53
|
+
| `gog_people_search` | Search the Workspace directory (covers internal users, unlike contacts search) |
|
|
54
|
+
| `gog_people_relations` | Get relations (manager, reports) for a user |
|
|
55
|
+
| `gog_people_raw` | Dump the raw People API response as JSON |
|
|
56
|
+
|
|
57
|
+
## License
|
|
58
|
+
|
|
59
|
+
MIT
|
package/SKILL.md
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gogcli-mcp-contacts
|
|
3
|
+
description: Use when the user asks to look up, search, or manage Google Contacts and the broader People API (Workspace directory). Triggers for contact lookups by name/email/phone, Workspace user search, profile fields, manager/reports relations, or any People API query.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# gogcli-mcp-contacts
|
|
7
|
+
|
|
8
|
+
Extended Google Contacts MCP server via [gogcli](https://github.com/steipete/gogcli) — 15 tools: auth + 5 base Contacts + 5 extra People API tools.
|
|
9
|
+
|
|
10
|
+
- **Source:** [github.com/chrischall/gogcli-mcp](https://github.com/chrischall/gogcli-mcp)
|
|
11
|
+
|
|
12
|
+
## Requirements
|
|
13
|
+
|
|
14
|
+
- [gogcli](https://github.com/steipete/gogcli) installed and authenticated
|
|
15
|
+
- Node.js 18 or later
|
|
16
|
+
|
|
17
|
+
## Setup
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{
|
|
21
|
+
"mcpServers": {
|
|
22
|
+
"gogcli-contacts": {
|
|
23
|
+
"command": "npx",
|
|
24
|
+
"args": ["-y", "gogcli-mcp-contacts"],
|
|
25
|
+
"env": {
|
|
26
|
+
"GOG_ACCOUNT": "you@gmail.com"
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Extra People Tools
|
|
34
|
+
|
|
35
|
+
| Tool | What it does |
|
|
36
|
+
|------|-------------|
|
|
37
|
+
| `gog_people_me` | Show your own profile |
|
|
38
|
+
| `gog_people_get` | Get a profile by resource name |
|
|
39
|
+
| `gog_people_search` | Search the Workspace directory |
|
|
40
|
+
| `gog_people_relations` | Manager/reports relations |
|
|
41
|
+
| `gog_people_raw` | Raw People API JSON dump |
|
|
42
|
+
|
|
43
|
+
Plus 5 auth tools and 5 base Contacts tools (`gog_contacts_search/list/get/create/run`). The base `gog_contacts_search` only sees your personal contacts; use `gog_people_search` for the full Workspace directory.
|