mercury-remote-macos-calendar

Read Calendar.app events from a remote macOS host over Mercury Remote.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/TitoPrausee/nexus-toti --skill mercury-remote-macos-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mercury-remote-macos-calendar
Source: https://github.com/TitoPrausee/nexus-toti/tree/main/data/skills/devops/mercury-remote-macos-calendar
Command: npx skills add https://github.com/TitoPrausee/nexus-toti --skill mercury-remote-macos-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of checking Calendar.app on a remote Mac by giving you a reliable way to inspect events over Mercury Remote without logging in interactively.

Core Features & Use Cases

  • Remote Calendar Access: Connect to a Mac over the Mercury Remote TCP mesh and retrieve calendar events programmatically.
  • macOS-aware Retrieval: Use AppleScript and icalBuddy workflows that fit modern macOS behavior, including Calendar permissions and EventKit changes.
  • Troubleshooting Guidance: Handle common failures such as missing permissions, incorrect icalBuddy flags, and empty database assumptions on newer macOS versions.
  • Use Case: A support engineer can quickly verify today’s meetings on a customer’s Mac, or a personal assistant can pull this week’s schedule from a remote machine without manual screen sharing.

Quick Start

Ask the skill to connect to the remote Mac and list Calendar.app events for today or a chosen date range.

Frequently Asked Questions about mercury-remote-macos-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Calendar.app events from a remote Mac without screen sharing?

You can retrieve remote Calendar.app events by connecting to a macOS host over Mercury Remote on TCP 9443. The Skill queries event data using either AppleScript or icalBuddy, returning the schedule for a specified date range without requiring interactive login.

What is needed to check a remote macOS calendar schedule programmatically?

Checking a remote macOS calendar requires a reachable Mercury peer on TCP 9443, the correct shared secret, and either icalBuddy or AppleScript Calendar access configured on the target host to successfully return event data.

How do I pull today's meetings from a remote Mac using icalBuddy?

To pull today's meetings, connect to the remote Mac over Mercury Remote and request a today's schedule review. The Skill executes icalBuddy commands on the host to fetch and return the current day's Calendar.app events.

Does remote calendar retrieval work with modern macOS EventKit permissions?

Yes, remote calendar retrieval supports modern macOS behavior by using AppleScript and icalBuddy workflows that account for EventKit changes. It includes troubleshooting guidance for handling missing Calendar permissions and empty database assumptions on newer macOS versions.

Why does icalBuddy return empty results when querying a remote Mac calendar?

icalBuddy returns empty results on newer macOS versions due to missing Calendar permissions, incorrect command flags, or empty database assumptions. The Skill provides troubleshooting guidance to resolve these common remote calendar access failures.

Can I use Mercury Remote to troubleshoot calendar access issues on a customer's Mac?

Yes, support engineers can use Mercury Remote to troubleshoot calendar access on a customer's Mac. The Skill verifies event retrieval, diagnoses missing permissions, and identifies incorrect icalBuddy flags without manual screen sharing.