Comlink
by chaosbit-dev
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COMLINK_PASSWORD | No | Bridge app password (NOT the Proton account password). Prefer the command form below. | |
| COMLINK_TLS_MODE | No | verify or no-verify. no-verify is refused for non-localhost hosts. | verify |
| COMLINK_USERNAME | No | Bridge username (usually your Proton address) | |
| COMLINK_AUDIT_LOG | No | Append-only JSONL of every send and delete. | ~/.comlink/audit.jsonl |
| COMLINK_HTTP_HOST | No | Bind address for streamable-http. Use 0.0.0.0 in a container. Ignored for stdio. | 127.0.0.1 |
| COMLINK_HTTP_PATH | No | Mount path for the streamable-http endpoint. Ignored for stdio. | /mcp |
| COMLINK_HTTP_PORT | No | Bind port for streamable-http. Ignored for stdio. | 8000 |
| COMLINK_IMAP_HOST | No | Bridge IMAP host | 127.0.0.1 |
| COMLINK_IMAP_PORT | No | Bridge IMAP port (STARTTLS) | 1143 |
| COMLINK_READ_ONLY | No | When true, only the five read tools are registered. Every write/organize/compose tool — including proton_send_message — is not registered and invisible to the client. Overrides COMLINK_ALLOW_SEND. | false |
| COMLINK_SMTP_HOST | No | Bridge SMTP host | 127.0.0.1 |
| COMLINK_SMTP_PORT | No | Bridge SMTP port | 1025 |
| COMLINK_TRANSPORT | No | stdio (Phase 1) or streamable-http (Phase 2, remote on Gonk behind Cloudflare Access). | stdio |
| COMLINK_ACCESS_AUD | No | Cloudflare Access application AUD tag (an identifier, not a secret). Required when the gate is on. | |
| COMLINK_ALLOW_SEND | No | Master send gate. When false, proton_send_message is not registered — the tool is invisible to the client, not just refusing. | false |
| COMLINK_SMTP_SECURITY | No | starttls (connect plaintext, upgrade in-band — Bridge default) or ssl (implicit TLS on connect). Set to ssl if your Bridge's SMTP is configured for SSL/TLS. | starttls |
| COMLINK_TLS_CERT_PATH | No | Pinned Bridge certificate for verify mode. | |
| COMLINK_SEND_ALLOWLIST | No | Comma-separated recipients. Exact address or *@domain wildcard. Empty + send enabled = any recipient (logged loudly at startup). | |
| COMLINK_PASSWORD_COMMAND | No | Shell command whose stdout is the app password, e.g. security find-generic-password -s proton-bridge -w (Keychain) or bw get password proton-bridge (Vaultwarden). Wins over COMLINK_PASSWORD if both are set. | |
| COMLINK_SEND_MAX_PER_HOUR | No | Sliding-window send rate limit. | 5 |
| COMLINK_ACCESS_TEAM_DOMAIN | No | Cloudflare Access team domain, e.g. chaosbit.cloudflareaccess.com. The issuer (https://<team>) and JWKS URL (https://<team>/cdn-cgi/access/certs) are derived from it. Required when the gate is on. | |
| COMLINK_HTTP_ALLOWED_HOSTS | No | Comma-separated Host allowlist for DNS-rebinding protection. When set, protection is on and only these hosts (and https://<host> origins) are accepted — set it to your public hostname (e.g. comlink.chaosbit.dev). When empty, protection is disabled with a logged warning: acceptable behind Cloudflare Access, never for bare-internet exposure. | |
| COMLINK_REQUIRE_ACCESS_JWT | No | Defense-in-depth gate for streamable-http. When true, every HTTP request must carry a valid Cf-Access-Jwt-Assertion header or it is rejected with 401 before reaching the MCP app. Requires COMLINK_ACCESS_AUD and COMLINK_ACCESS_TEAM_DOMAIN (startup fails fast otherwise). Ignored for stdio. | false |
| COMLINK_ACCESS_ALLOWED_EMAILS | No | Comma-separated allowlist of email claim values (e.g. brandon@chaosbit.dev,alt@example.com). Empty disables the per-email check (signature/aud/iss/time are still enforced). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues