Skip to main content
Glama
Preeti325

MCP Calendar Tools

by Preeti325

MCP Calendar Tools

This Model Context Protocol (MCP) server provides tools for reading and managing calendar events using local .ics (iCalendar) files. It is completely offline and does not require complex OAuth setups with Google/Apple.

Overview

The mcp-calendar server exposes these tools:

  1. get_schedule: Reads the .ics file and lists events for a specific date.

  2. create_event: Creates a new event and appends it to your .ics file.

Related MCP server: ICS Calendar MCP Server

Prerequisites

  1. Node.js installed (v18 or higher recommended).

  2. Calendar File: Place an exported calendar file named calendar.ics in the root of this project (or specify the path in your config).

Steps to Run

  1. Install Dependencies:

    npm install
  2. Build the Project:

    npm run build
  3. Configure MCP: Add this server to your Claude Desktop or Antigravity MCP configuration file:

    {
      "mcpServers": {
        "calendar": {
          "command": "node",
          "args": ["/absolute/path/to/mcp-calendar/build/index.js"],
          "env": {
             "CALENDAR_FILE_PATH": "/absolute/path/to/your/calendar.ics"
          }
        }
      }
    }

    (Note: Adjust the absolute path to point to where you saved this folder. If CALENDAR_FILE_PATH is omitted, it defaults to ./calendar.ics in the project root).

  4. Restart your MCP Client. You can now ask the AI to "Check my schedule for tomorrow" or "Add a meeting at 3 PM".

Available Tools

2 tools
create_eventC

Create a new event in the local calendar

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYesEvent title
endDateYesEnd time (ISO string e.g. 2026-07-18T11:00:00Z)
startDateYesStart time (ISO string e.g. 2026-07-18T10:00:00Z)
descriptionNoOptional description

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. 'Create' implies a write/mutation operation, but the description doesn't state whether events overwrite conflicts, whether validation is applied, whether creation is reversible, or what the return/confirmation looks like. For a mutation tool with zero annotation coverage, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single concise sentence with zero waste. It's appropriately front-loaded. The only criticism is that it could be slightly more expanded to cover behavioral details, but as a purely concise statement it's efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations, no output schema, and a sibling (get_schedule) that implies read/write pairing, the description should offer more. Critical gaps: no mention of what happens on date conflicts, no return value description, no statement about whether this is a state-changing operation with side effects. The tool is simple (4 params, no nesting), but it's a write operation with zero behavioral disclosure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 4 parameters are already described in the schema. The description 'Create a new event' adds no distinct semantic value beyond what the schema encodes. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Create a new event in the local calendar' with a clear verb+resource. It distinguishes from the sibling get_schedule by being a write operation, though it doesn't explicitly differentiate its role. The purpose is clear but minimal.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs get_schedule, or when not to use it. There's no mention of prerequisites, format expectations for dates beyond what the schema shows, or any exclusions. The sibling distinction is implicit (create vs read) but never stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_scheduleA

List all events for a specific date from the local calendar

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoDate in YYYY-MM-DD format (defaults to today)

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden of behavioral disclosure. It states this reads from the 'local calendar' but doesn't disclose return format, whether it's a read-only operation (implied by 'List'), pagination, or locale/timezone handling. It's adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, clear sentence with zero wasted words. The description efficiently conveys the tool's purpose and highlights the key date-based scoping without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read/list tool with 100% schema coverage, the description is reasonably complete. It lacks additional context like return format or timezone considerations, but given the tool's simplicity and the exhaustive schema, these are minor gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% for the single date parameter, including format (YYYY-MM-DD) and default (today). The description reinforces the parameter's role by stating events are for 'a specific date', adding modest value beyond the schema. Default-to-today behavior is a useful nuance.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('List') with a clear resource ('all events') and scope ('for a specific date from the local calendar'). It clearly distinguishes from the sibling create_event tool by focusing on reading/listing rather than creation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description conveys that it reads local calendar events by date, which implicitly distinguishes it from create_event (the only sibling). However, it doesn't explicitly state when to use this vs alternatives or provide exclusions/edge conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedcreate_event
    • First observedget_schedule

TDQS

B3/5.0
Disambiguation5/5

The two tools serve clearly distinct purposes: one reads/queries events while the other creates new ones. There is no ambiguity between them, and each has a single unambiguous responsibility.

Naming Consistency4/5

Both tools follow a consistent verb_noun pattern (get_schedule, create_event), using snake_case throughout. Minor inconsistency exists in noun phrasing (schedule vs event) but the pattern is otherwise predictable and readable.

Tool Count2/5

Two tools feels very thin for a calendar server. A calendar domain typically warrants at least update/delete operations and date-range queries, making this extremely sparse for its apparent purpose.

Completeness1/5

The surface is severely incomplete. It covers only retrieving events for a single date and creating an event, but lacks update_event, delete_event, list_all_events, searching by range, and any management capabilities. This severely limits what agents can accomplish.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Preeti325/mcp-calendar'

If you have feedback or need assistance with the MCP directory API, please join our Discord server