cal2prompt

Fetches Google Calendar events and formats them into a configurable prompt; includes an experimental MCP server mode.

rust

14

GitHub Stars

rust

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shuntaka9576-cal2prompt": {
      "command": "/Users/username/.cargo/bin/cal2prompt",
      "args": [
        "mcp"
      ],
      "env": {
        "HOME": "/Users/username"
      }
    }
  }
}

You can run cal2prompt as an MCP server to let AI models request calendar-aware context and receive formatted prompts. This makes it easy to supply up-to-date schedule data to your language model workflows, while keeping the data retrieval and rendering logic isolated and reusable.

How to use

Run cal2prompt as an MCP server to serve generated prompts to MCP clients. The server is designed to fetch events from Google Calendar, render them through a template engine, and expose them via an MCP interface so you can plug it into your AI workflows without code changes.

How to install

Prerequisites: you need a Rust toolchain to build and install the binary, and you will use a Google Calendar OAuth2 client for calendar access.

Install with Cargo (recommended):

git clone https://github.com/shuntaka9576/cal2prompt
cd cal2prompt
cargo install --path .

Additional setup and configuration

Prepare Google OAuth2 credentials and calendar IDs, then configure the client locally. You will store credentials and settings in Lua configuration files as shown.

OAuth setup and token storage paths are required for Google Calendar access. You will authenticate once and the token will be saved to your platform's data directory.

MCP server configuration for Claude Desktop

Use an MCP configuration so Claude Desktop can talk to cal2prompt as a local server. The following example shows how to point Claude Desktop to the local MCP server and ensure HOME is set for the environment.

{
  "mcpServers": {
    "cal2prompt": {
      "command": "/Users/username/.cargo/bin/cal2prompt",
      "args": ["mcp"],
      "env": {
        "HOME": "/Users/username"
      }
    }
  }
}

Notes on authentication and token management

The authentication flow uses OAuth 2.0 to obtain credentials for Google Calendar access. Tokens are stored locally to enable seamless subsequent fetches without re-authenticating each time.

Available tools

mcp_server

Launch cal2prompt as an MCP server to provide calendar-aware prompts to MCP clients.

template_engine

Render calendar data into prompts using a template engine to produce consistent, model-friendly inputs.