@nylas/helix-mcp-server 0.1.0 → 0.1.3
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 +52 -0
- package/package.json +7 -5
package/README.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# @nylas/helix-mcp-server
|
|
2
|
+
|
|
3
|
+
MCP server and CLI for [Nylas Helix](https://helix.nylas.com) — email, calendar, contacts, and identity context for AI agents.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx @nylas/helix-mcp-server@latest --setup
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
This registers Helix as an MCP server in Claude Code using the OAuth 2.0 device code flow:
|
|
12
|
+
|
|
13
|
+
1. Registers as an OAuth client with your Helix instance
|
|
14
|
+
2. Displays a code and opens the browser for approval
|
|
15
|
+
3. Polls until you approve the scopes
|
|
16
|
+
4. Registers the MCP endpoint with `claude mcp add`
|
|
17
|
+
|
|
18
|
+
Restart Claude Code after setup to activate.
|
|
19
|
+
|
|
20
|
+
## Commands
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npx @nylas/helix-mcp-server --setup # Set up Helix MCP in Claude Code
|
|
24
|
+
npx @nylas/helix-mcp-server --uninstall # Remove Helix MCP from Claude Code
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## What It Provides
|
|
28
|
+
|
|
29
|
+
Once connected, Claude Code gets tools for:
|
|
30
|
+
|
|
31
|
+
- **Email** — read threads, search, send (approval-gated)
|
|
32
|
+
- **Calendar** — read events, create events (approval-gated)
|
|
33
|
+
- **Contacts** — search contacts
|
|
34
|
+
- **Identity** — read identity config, pending actions, approve/reject
|
|
35
|
+
|
|
36
|
+
All actions respect the permissions and approval policies configured in your Helix identity.
|
|
37
|
+
|
|
38
|
+
## Environment Variables
|
|
39
|
+
|
|
40
|
+
| Variable | Default | Description |
|
|
41
|
+
|----------|---------|-------------|
|
|
42
|
+
| `HELIX_URL` | `https://helix.nylas.com` | Helix instance URL (for self-hosted or local dev) |
|
|
43
|
+
|
|
44
|
+
## Uninstall
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
npx @nylas/helix-mcp-server --uninstall
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## License
|
|
51
|
+
|
|
52
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nylas/helix-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "MCP server and CLI for Nylas Helix — email, calendar, contacts, and identity context for AI agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
7
7
|
"types": "./dist/index.d.ts",
|
|
8
8
|
"bin": {
|
|
9
|
-
"helix-mcp-server": "
|
|
9
|
+
"helix-mcp-server": "dist/cli.js"
|
|
10
10
|
},
|
|
11
11
|
"exports": {
|
|
12
12
|
".": {
|
|
@@ -15,13 +15,15 @@
|
|
|
15
15
|
}
|
|
16
16
|
},
|
|
17
17
|
"files": [
|
|
18
|
-
"dist"
|
|
18
|
+
"dist",
|
|
19
|
+
"README.md"
|
|
19
20
|
],
|
|
20
21
|
"scripts": {
|
|
21
22
|
"build": "tsc",
|
|
22
23
|
"prepack": "pnpm run build",
|
|
23
24
|
"lint": "biome check src/",
|
|
24
|
-
"test": "vitest run"
|
|
25
|
+
"test": "vitest run",
|
|
26
|
+
"release": "npm version patch && npm publish --access public && git push origin main --tags"
|
|
25
27
|
},
|
|
26
28
|
"keywords": [
|
|
27
29
|
"mcp",
|
|
@@ -34,7 +36,7 @@
|
|
|
34
36
|
],
|
|
35
37
|
"repository": {
|
|
36
38
|
"type": "git",
|
|
37
|
-
"url": "https://github.com/nylas/helix"
|
|
39
|
+
"url": "git+https://github.com/nylas/helix.git"
|
|
38
40
|
},
|
|
39
41
|
"license": "MIT",
|
|
40
42
|
"dependencies": {
|