Advertise
MCP.so
Sign In

MCP iCal Server

@kristofferv98

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

kristofferv98

About MCP iCal Server

Mcp server with singular tool communication to agent using o4-mini with OpenAI Agent SDK integration to manage google/apple calendar.

#mcp#calender#calender-event#mcp-server#openai-agents#openai-agent-sdk#openai-agents-sdk#o4-mini

MCP iCal Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Mcp_calender_agent": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

MCP iCal 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 MCP iCal Server?

MCP iCal Server is an MCP (Model Context Protocol) server that enables AI agents to manage macOS calendars using natural language. It integrates with the macOS Calendar app and uses the OpenAI Agent SDK to provide a single, agent-powered entry point for all calendar operations. It is designed for users of MCP-compatible clients like Claude for Desktop who want to create, query, and update calendar events conversationally.

How to use MCP iCal Server?

Install the server with uv sync, then configure your MCP client (e.g., Claude for Desktop) by adding the server to claude_desktop_config.json with your OPENAI_API_KEY as an environment variable. Launch Claude from the terminal to trigger macOS calendar permissions. Once set up, invoke the single MCP tool send_to_calendar_agent with natural language requests like “What’s my schedule for next week?” or “Add a lunch meeting with Sarah tomorrow at noon.”

Key features of MCP iCal Server

  • Single MCP tool (send_to_calendar_agent) for all operations
  • Stateful conversations that maintain context between requests
  • Natural language event creation with location, notes, and reminders
  • Smart schedule queries and availability checking
  • Intelligent event updates (time, date, calendar, notes)
  • Multi-calendar support, including Google Calendar via iCloud sync

Use cases of MCP iCal Server

  • Schedule meetings and appointments using natural language
  • Check your availability for a given time window
  • Modify existing events (reschedule, move to another calendar)
  • View and manage events across multiple macOS calendars

Frequently asked questions

1

What is the single MCP tool exposed by this server?

The server exposes one tool called `send_to_calendar_agent`. When invoked, it passes the user’s natural language request to a specialized calendar agent built with the OpenAI Agent SDK.

2

How does this server differ from traditional MCP implementations?

Traditional MCP servers expose multiple tools for different operations. This server uses an agent-based approach with a single entry point, stateful conversations, and automatic natural language processing, simplifying client integration.

3

What are the prerequisites for using MCP iCal Server?

You need macOS with the Calendar app configured, the `uv` package manager, an OpenAI API key set as the `OPENAI_API_KEY` environment variable, and an MCP-compatible client (Claude for Desktop is recommended).

4

Are there any known issues with recurring events?

Non-standard recurring schedules may not always be set correctly. Better results are achieved with more powerful LLM models. Reminder timing for recurring all-day events may be off by one day.

5

How do I grant calendar permissions to the server?

Claude (or your MCP client) must be launched from the terminal (e.g., `/Applications/Claude.app/Contents/MacOS/Claude`) to properly trigger the macOS calendar permissions prompt. Launching from Finder will not work.

Comments

More AI & Agents MCP servers

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei

q-ring

I4cTime

Quantum-inspired keyring for AI coding agents. Secure secrets with superposition, entanglement, tunneling, and teleportation — CLI + 44 MCP tools.

3

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

scvd.store

seancrecord

scvd.store is an evidence observatory for agentic commerce. Independent signed observation of what other people's endpoints, artifacts and payments actually did among other things. USDC on Base, Arbitrum One, World Chain

2

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

1
Advertise