Cron Job Email Scheduler CronGrid

by chaser164

258 downloads
Not rated
GitHub

About

Schedule, retrieve, and delete SendGrid cron jobs using natural language commands. Manage your email sends effortlessly through an LLM interface with timezone-aware capabilities. Super-charge a reminder suite of your own with scheduled emails to yourself.

Details

Author
chaser164
Downloads
258
Categories
Communication

- Schedule email sends via SendGrid using cron jobs
- POST, GET, and DELETE cron jobs through LLM commands
- Automatically retrieves current date/time to aid scheduling
- Defaults to self-emailing if no recipient is specified

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cron Job Email Scheduler CronGrid
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via Smithery or manually. For manual setup, clone the repository and add a configuration entry to your MCP client’s JSON file (e.g., claude_desktop_config.json) with the required environment variables: SENDGRID_API_KEY, CRONJOB_API_KEY, FROM_EMAIL, and optional TZ. Then ask your LLM to create, get, or delete scheduled emails. If no recipient email is specified, the server defaults to sending to the sender’s email address.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cron job email scheduler crongrid": {
            "cronjob_email_mcp": {
                "command": "~/.local/bin/uv",
                "args": [
                    "--directory",
                    "/path/to/sendgrid-cronjob-mcp",
                    "run",
                    "email-schedule-send-mcp-server.py"
                ],
                "env": {
                    "SENDGRID_API_KEY": "<SendGrid API key>",
                    "CRONJOB_API_KEY": "<Cron-Job.org API key>",
                    "FROM_EMAIL": "<SendGrid verified single sender email address>",
                    "TZ": "<IANA timezone value>"
                }
            }
        }
    }
}

McpServers

{
    "cronjob_email_mcp": {
        "command": "~/.local/bin/uv",
        "args": [
            "--directory",
            "/path/to/sendgrid-cronjob-mcp",
            "run",
            "email-schedule-send-mcp-server.py"
        ],
        "env": {
            "SENDGRID_API_KEY": "<SendGrid API key>",
            "CRONJOB_API_KEY": "<Cron-Job.org API key>",
            "FROM_EMAIL": "<SendGrid verified single sender email address>",
            "TZ": "<IANA timezone value>"
        }
    }
}

CronGrid — an MCP server scheduling SendGrid Cron Jobs!

smithery badge

Description

This MCP server enables LLMs to POST, GET, and DELETE cron jobs that schedule email sends via SendGrid.

Prerequisites

- Claude Desktop (or another MCP server-compatible LLM interface of your choice) installed on your local machine - If using Smithery: Node.js (version 14 or higher) installed - If running locally: uv installed - SendGrid account with verified single sender email address - Cron-Job.Org account

Installation

Installing via Smithery

To install CronGrid automatically via Smithery (example for Claude Desktop):

npx -y @smithery/cli install @chaser164/sendgrid-cronjob-mcp --client claude

Installing Manually

- Open your terminal or command line.
- Run git clone https://github.com/chaser164/sendgrid-cronjob-mcp.git
- Add the below to your MCP server-compatible interface of choice (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "cronjob_email_mcp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/sendgrid-cronjob-mcp",
        "run",
        "email-schedule-send-mcp-server.py"
      ],
      "env": {
        "SENDGRID_API_KEY": "<SendGrid API key>",
        "CRONJOB_API_KEY": "<Cron-Job.Org API key>",
        "FROM_EMAIL": "<SendGrid verified single sender email>"
        "TZ": "<timezone value>",
      }
      
    }
  }
}

NOTE: timezone environment variable values must be chosen from this list. The default timezone value is UTC.

Usage

- Ask your LLM to create, get, and delete scheduled emails
- This MCP also has the ability to get the current date/time to enhance its scheduling capabilities
- If a "to email" is not specified, the mcp will send an email to yourself (e.g., "remind me to dance" will send an email to the specified SendGrid sender identity's email address)

License

This project is licensed under the MIT License.

Contributions

Contributions are welcome. Feel free to open issues or submit a pull request for feature enhancements or bug fixes.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.