Doubletick Cli

What cseguinlz/doubletick-cli MCP server does

The cseguinlz/doubletick-cli MCP server exposes Gmail email tracking to MCP-compatible agents. It supports sending an email with a read-tracking pixel, checking whether a tracked message was opened, and listing recent tracked messages with their statistics.

Email content can be supplied as text or Markdown, or as HTML when using the CLI. The underlying command-line interface also supports CC and BCC recipients. Tracking information can include whether a message was opened, the open count, device information, and timing, according to the listing and backend behavior described by the project.

How it works

The sending workflow converts the composed message to HTML when needed, creates a tracking ID, and inserts a 1x1 tracking pixel. Gmail delivers the message through the Gmail API. The track is registered with the DoubleTick backend, which serves the pixel and records opens when the recipient's mail client loads it.

The cseguinlz/doubletick-cli MCP server uses the same local credentials as the CLI. Its tracking data is handled by the DoubleTick backend, including open logging, deduplication, device detection, status checks, and dashboard data. Tracks created from the CLI appear alongside tracks created through the DoubleTick Chrome extension.

Setup and configuration

The project requires Node.js 18 or newer, a Gmail account, and a DoubleTick account. Begin by installing the package globally if you want to use the command-line commands:

npm install -g doubletick-cli

Run doubletick login once to authenticate with Gmail and DoubleTick. The command opens a browser for Google sign-in and stores credentials locally at ~/.doubletick/credentials.json. The MCP process reads those stored credentials, so login must happen before starting the server. doubletick logout removes the saved credentials.

For an MCP client using stdio, the project documents this configuration:

{
  "mcpServers": {
    "doubletick": {
      "command": "npx",
      "args": ["-y", "doubletick-cli"]
    }
  }
}

Tools and capabilities

The cseguinlz/doubletick-cli MCP server provides three tools:

• send_tracked_email: Sends an email through Gmail with read tracking enabled.
• check_tracking_status: Checks whether a tracked message has been opened.
• list_tracked_emails: Returns recent tracked emails with their available statistics.

The equivalent CLI commands are doubletick send, doubletick status, and doubletick dashboard. Status checks can target the latest tracked message, a recipient, or a tracking ID. The dashboard command accepts a result limit.

Limitations and notes

Tracking depends on the recipient's email client loading the embedded pixel, so an open can only be recorded when that request reaches the tracking service. The project does not describe a separate SMTP delivery path; sending is performed through Gmail's API.

A DoubleTick account is required, and the documented free tier allows five tracked emails per week. The README does not specify environment variables for configuration or an alternate authentication method. The project is licensed under MIT.