cal2prompt MCP Server

@shuntaka9576

Repository

Basic information

About cal2prompt MCP Server

✨ Fetches your schedule (Google Calendar) and outputs it as a single LLM prompt, with an optional MCP server mode.

cal2prompt MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

cal2prompt MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is cal2prompt?

cal2prompt is a command-line tool that fetches your schedule (e.g., from Google Calendar) and converts it into a custom prompt or text snippet via a Jinja2 template engine. It can output directly to stdout, or run as an experimental MCP (Model Context Protocol) server.

How to use cal2prompt?

Install via brew install shuntaka9576/tap/cal2prompt or build from source with Cargo. Set up a Google OAuth2 client, create Lua configuration files (~/.config/cal2prompt/config.lua and secrets.lua), then run cal2prompt with date‑range flags (e.g., --today, --this-week) or use the mcp subcommand to launch the experimental MCP server.

Key features of cal2prompt

Google Calendar integration via Calendar API v3
Custom LLM prompt generation with a Jinja2 template engine
High‑speed processing built with the Rust ecosystem
Experimental MCP (Model Context Protocol) server mode

Use cases of cal2prompt

Generate a daily or weekly schedule summary as a prompt for an AI assistant
Feed live calendar events into an LLM via the MCP server (e.g., Claude Desktop)
Produce custom‑formatted text snippets for time‑blocking or status reports
Combine multiple Google Calendars into a single chronological overview

Frequently asked questions

How does authentication work?

cal2prompt uses Google OAuth2. You must create your own Google project and OAuth client; the generated token is stored in `~/.local/share/cal2prompt/oauth`. The first run automatically starts the authentication flow.

What configuration format does cal2prompt use?

Configuration is written in Lua using two files: `secrets.lua` for sensitive data (client ID, client secret, calendar IDs) and `config.lua` for the main setup (time zone, template, etc.).

How can I use cal2prompt as an MCP server with Claude Desktop?

Add a `mcpServers` entry in `claude_desktop_config.json` specifying the full path to the `cal2prompt` binary and the `mcp` argument, plus the `HOME` environment variable.

Are there any known limitations?

The MCP mode is experimental and may change without notice. You must supply your own Google Calendar API token; the project owner cannot provide a pre‑approved client due to security and approval constraints.

Where are OAuth tokens stored?

Tokens are stored in the file defined by the `settings.oauthFilePath` configuration option, defaulting to `~/.local/share/cal2prompt/oauth`.

Comments

More Productivity MCP servers

send-email

mcp.build

send-email is a remote MCP server available at https://next.hal9.ai.

Local MCP (LMCP)

lanchuske

Local tools that let your AI use Mail, Calendar, Contacts, Teams, Slack, WhatsApp, OneDrive, Google Drive, Notion, Outlook and Office files on Mac and Windows. Runs on your computer.

Etincel

AIStoryHub

Find the AI tells in your prose. Deterministic, local, runs in CI. MCP server + CLI + Action.

Credential Camp

Copliancy Inc

Employee credential, certification and training tracking for multi-location teams: expiring and overdue credentials, training gaps and location compliance, with owner-controlled write approvals.

EQIQs

EQIQs brings working-style and compatibility insights into Claude. Managers and coaches can take or send a short assessment, compare two people, get a read on a team of up to 12, prepare for meetings with tips that fit t