Skip to main content
Glama
Comlink

Comlink

by chaosbit-dev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
COMLINK_PASSWORDNoBridge app password (NOT the Proton account password). Prefer the command form below.
COMLINK_TLS_MODENoverify or no-verify. no-verify is refused for non-localhost hosts.verify
COMLINK_USERNAMENoBridge username (usually your Proton address)
COMLINK_AUDIT_LOGNoAppend-only JSONL of every send and delete.~/.comlink/audit.jsonl
COMLINK_HTTP_HOSTNoBind address for streamable-http. Use 0.0.0.0 in a container. Ignored for stdio.127.0.0.1
COMLINK_HTTP_PATHNoMount path for the streamable-http endpoint. Ignored for stdio./mcp
COMLINK_HTTP_PORTNoBind port for streamable-http. Ignored for stdio.8000
COMLINK_IMAP_HOSTNoBridge IMAP host127.0.0.1
COMLINK_IMAP_PORTNoBridge IMAP port (STARTTLS)1143
COMLINK_READ_ONLYNoWhen 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_HOSTNoBridge SMTP host127.0.0.1
COMLINK_SMTP_PORTNoBridge SMTP port1025
COMLINK_TRANSPORTNostdio (Phase 1) or streamable-http (Phase 2, remote on Gonk behind Cloudflare Access).stdio
COMLINK_ACCESS_AUDNoCloudflare Access application AUD tag (an identifier, not a secret). Required when the gate is on.
COMLINK_ALLOW_SENDNoMaster send gate. When false, proton_send_message is not registered — the tool is invisible to the client, not just refusing.false
COMLINK_SMTP_SECURITYNostarttls (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_PATHNoPinned Bridge certificate for verify mode.
COMLINK_SEND_ALLOWLISTNoComma-separated recipients. Exact address or *@domain wildcard. Empty + send enabled = any recipient (logged loudly at startup).
COMLINK_PASSWORD_COMMANDNoShell 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_HOURNoSliding-window send rate limit.5
COMLINK_ACCESS_TEAM_DOMAINNoCloudflare 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_HOSTSNoComma-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_JWTNoDefense-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_EMAILSNoComma-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

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources