Skip to main content
Glama
YearAtAGlance MCP Server

YearAtAGlance MCP Server

by mindfullabai

YearAtAGlance MCP Server

MCP (Model Context Protocol) server for integrating YearAtAGlance calendar with Claude Code and other MCP-compatible AI assistants.

Installation

npm install -g @yearataglance/mcp-server

Or use directly with npx:

npx @yearataglance/mcp-server

Related MCP server: MCP Calendar Assistant

Configuration

1. Get your API Key

  1. Go to YearAtAGlance

  2. Navigate to Profile > API Keys

  3. Create a new API key with the permissions you need

  4. Copy the key (it's only shown once!)

2. Configure Claude Code

Add to your ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "yearataglance": {
      "command": "npx",
      "args": ["@yearataglance/mcp-server"],
      "env": {
        "YAAG_API_KEY": "your-api-key-here",
        "YAAG_API_URL": "https://yearataglance-backend-production.up.railway.app/api/v1"
      }
    }
  }
}

Available Tools

Events

Tool

Description

yaag_list_events

List all events, optionally filtered by year and category

yaag_get_event

Get details of a specific event

yaag_create_event

Create a new event

yaag_update_event

Update an existing event

yaag_delete_event

Delete an event

yaag_get_heatmap

Get event density heatmap for a year

Categories

Tool

Description

yaag_list_categories

List all categories

yaag_get_category

Get details of a specific category

yaag_create_category

Create a new category

yaag_update_category

Update an existing category

yaag_delete_category

Delete a category

AI

Tool

Description

yaag_ai_status

Check AI service status

yaag_ai_create_milestone

Create event from natural language

yaag_ai_analyze_year

Get AI analysis of a year's events

yaag_ai_chat

Chat with AI about your calendar

Usage Examples

Once configured, you can use natural language in Claude Code:

"Show me all my events for 2025"
"Create an event called 'Team Offsite' from March 10-12"
"What categories do I have?"
"Create a new category called 'Health' with green color"
"Delete the event with ID xyz123"

Environment Variables

Variable

Required

Default

Description

YAAG_API_KEY

Yes

-

Your YearAtAGlance API key

YAAG_API_URL

No

Production URL

API base URL

Permissions

API keys can have different permissions:

  • read: List and view events/categories

  • write: Create, update, delete events/categories

  • ai: Use AI features (milestone creation, analysis, chat)

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Available Tools

15 tools
yaag_ai_analyze_yearA

Get AI-powered analysis and insights for a specific year's events

Inputs: year (required).

yaag_ai_chatA

Chat with the AI assistant about your calendar, events, and schedule

Inputs: message (required), conversationId.

yaag_ai_create_milestoneA

Use AI to create an event from natural language input. Example: 'My birthday on March 15th' or 'Team offsite next week'

Inputs: input (required), year.

yaag_ai_statusA

Check the status of the AI service in YearAtAGlance

Inputs: no named parameters.

yaag_create_categoryB

Create a new category for organizing events

Inputs: name (required), color (required), description.

yaag_create_eventB

Create a new event in the YearAtAGlance calendar. Dates should be in ISO 8601 format.

Inputs: title (required), startDate (required), endDate (required), description, +2 more.

yaag_delete_categoryA

Delete a category. Events in this category will become uncategorized.

Inputs: categoryId (required).

yaag_delete_eventB

Delete an event from the calendar

Inputs: eventId (required).

yaag_get_categoryB

Get details of a specific category by its ID

Inputs: categoryId (required).

yaag_get_eventB

Get details of a specific event by its ID

Inputs: eventId (required).

yaag_get_heatmapA

Get heatmap data showing event density for each day of a year

Inputs: year (required).

yaag_list_categoriesA

List all categories in the YearAtAGlance calendar

Inputs: no named parameters.

yaag_list_eventsB

List all events from YearAtAGlance calendar. Optionally filter by year and/or category.

Inputs: year, categoryId.

yaag_update_categoryC

Update an existing category

Inputs: categoryId (required), name, color, description.

yaag_update_eventC

Update an existing event

Inputs: eventId (required), title, startDate, endDate, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 15 tools

    Disambiguation5/5

    Tools are clearly grouped into AI operations, category CRUD, and event CRUD, with no overlapping purposes. Each tool has a distinct function that is easy to differentiate.

    Naming Consistency4/5

    All tools share the 'yaag_' prefix, but the AI tools (e.g., 'yaag_ai_chat') have a slightly different naming pattern compared to the CRUD tools (e.g., 'yaag_create_category'). Overall consistent but with minor deviation.

    Tool Count5/5

    15 tools is appropriate for a calendar management server with AI features, covering creation, retrieval, updating, deletion, listing, and analysis without being excessive.

    Completeness4/5

    Full CRUD operations for events and categories are provided, along with AI analysis and heatmap visualization. Missing advanced features like bulk operations or search, but core workflows are well-covered.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Google Calendar through natural language interactions with features like creating, updating, and deleting events, searching calendars, and supporting natural language date/time inputs.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage calendars and tasks through natural language, supporting Google Calendar operations like event creation, availability checking, and smart scheduling. It features schedule analysis, task reminders, and meeting time recommendations to streamline productivity.
      MIT