{
 "schema_version": 1,
 "generated": "2026-10-24",
 "id": "cccrafts-punctual--let-an-ai-agent-read-and-book-your-calendar",
 "repo": "CCCrafts/punctual",
 "repo_url": "https://github.com/CCCrafts/punctual",
 "repo_slug": "cccrafts-punctual",
 "title": "Let an AI agent check and manage your calendar",
 "page_title": "How to let an AI agent check and manage your calendar with Punctual",
 "summary": "Use the built-in MCP server so an AI agent can call your scheduling data as tools.",
 "who": "A founder or operator who already uses an AI agent for daily planning and wants it to see open slots and bookings.",
 "problem": "An agent cannot answer 'when am I free next week' without a live connection to the calendar it is supposed to reason about.",
 "outcome": "An MCP-connected agent that can query your Punctual calendar and report availability.",
 "steps": [
  "Deploy your Punctual instance using `npx punctual-sh init` or the manual steps in the README.",
  "Locate the MCP endpoint of your deployed Worker in docs/self-hosting.md or the Worker URL printed by the deploy. (inferred, check the README)",
  "Add that MCP endpoint to your agent's MCP server settings. (inferred, check the README)",
  "Ask the agent to list open slots for the next five working days and check that the times match the booking page."
 ],
 "agent_prompt": "Using the CCCrafts/punctual repo, connect an MCP client to the deployed Punctual Worker at <worker-url> and list the tools it exposes. Return the tool names and one sample availability result, and verify the times against the public booking page.",
 "agents": [
  "any"
 ],
 "difficulty": "Advanced",
 "time": "1 hour",
 "basis": "readme",
 "caveat": "The README mentions a built-in MCP server but does not list its tools or how to authenticate, so verify both in the repo before relying on them.",
 "category": "Work and operations",
 "tags": [
  "Work and operations"
 ],
 "lang": "typescript",
 "requirements": [
  "Node 20+",
  "A Cloudflare account",
  "Command-line access to run wrangler",
  "Your own Google or Microsoft OAuth app, only if you want calendar sync"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "An MCP connection gives the agent access to your calendar data, so only connect it to agents and hosts you trust."
  }
 ],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/cccrafts-punctual/let-an-ai-agent-read-and-book-your-calendar/",
 "md": "https://dedupedai.com/use-cases/cccrafts-punctual/let-an-ai-agent-read-and-book-your-calendar/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/cccrafts-punctual--let-an-ai-agent-read-and-book-your-calendar.json",
 "api_version": "v1"
}