Agent skill

Outlook Calendar

by vellum-ai in vellum-ai/vellum-assistant

View Outlook Calendar events for any day, create and manage events, and check availability

MITAuto-check passed

Install Outlook Calendar

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill outlook-calendar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant outlook-calendar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/outlook-calendar .claude/skills/outlook-calendar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
outlook-calendar
GitHub stars
1.4k
Token cost
~1.7k tokens
SKILL.md length
681 words
Files
6 (incl. scripts, assets)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

View Outlook Calendar events for any day, create and manage events, and check availability

  • Works in 2 steps: Check connection health first. Run… → If no connection is found or the status…
  • SKILL.md covers Script Reference, Usage Examples, Connection Setup and Scheduling Playbook, plus 3 more sections
  • Runs TypeScript scripts from its folder; calls bun

What it does

Outlook Calendar is an agent skill from vellum-ai/vellum-assistant. View Outlook Calendar events for any day, create and manage events, and check availability

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and assets (for example `scripts/lib/common.test.ts`, `scripts/lib/common.ts` and `scripts/lib/outlook-cal-client.ts`). Compatibility notes: Designed for Vellum personal assistants

It works with Microsoft Outlook. The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/outlook-calendar”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Check connection health first. Run assistant oauth status outlook. This checks whether the user's Outlook/Microsoft account is connected…
  2. If no connection is found or the status check fails: Load the vellum-oauth-integrations skill. The skill will evaluate whether managed or…

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

Outlook Calendar loads about 1.7k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 681 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 681 words, ~1,670 tokens.

Download SKILL.mdSave it as .claude/skills/outlook-calendar/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
outlook-calendar
description
View Outlook Calendar events for any day, create and manage events, and check availability
compatibility
Designed for Vellum personal assistants
metadata.icon
assets/icon.svg
metadata.emoji
📅

Script Reference

All operations use a single CLI script that returns JSON:

  • Success: { "ok": true, "data": ... }
  • Failure: { "ok": false, "error": "..." }
ScriptSubcommandDescription
scripts/outlook-cal.tslistList events within a date range (supports OData $filter)
scripts/outlook-cal.tsgetGet full details of a specific event
scripts/outlook-cal.tscreateCreate a new event (requires user confirmation)
scripts/outlook-cal.tsavailabilityCheck free/busy times across calendars
scripts/outlook-cal.tsrsvpRespond to an event invitation (accepted, declined, tentative)

Usage Examples

bash
# List events in a date range
bun scripts/outlook-cal.ts list --start-date-time "2024-01-15T00:00:00Z" --end-date-time "2024-01-22T00:00:00Z"

# List events with an OData filter
bun scripts/outlook-cal.ts list --filter "subject eq 'Team Meeting'"

# Get full details of a specific event
bun scripts/outlook-cal.ts get --event-id "AAMkAD..."

# Create a new event (gates on assistant ui confirm)
bun scripts/outlook-cal.ts create --subject "Team Meeting" --start "2024-01-15T09:00:00-05:00" --end "2024-01-15T10:00:00-05:00" --timezone "America/New_York"

# Check availability for a day
bun scripts/outlook-cal.ts availability --start "2024-01-15T00:00:00Z" --end "2024-01-15T23:59:59Z"

# RSVP to an event invitation
bun scripts/outlook-cal.ts rsvp --event-id "AAMkAD..." --response accepted

# Target a specific connected account (see "Multiple Accounts" below)
bun scripts/outlook-cal.ts list --start-date-time "2024-01-15T00:00:00Z" --end-date-time "2024-01-22T00:00:00Z" --account "work@example.com"

Every subcommand accepts --account <email> to select which connected Outlook/Microsoft account the request runs against. When omitted, the request runs against a single account chosen automatically — safe only when exactly one Outlook account is connected. Each JSON envelope echoes the queried account in an account field when it is reported by the OAuth layer, so an empty result is self-describing (e.g. No events found in the specified time range for work@example.com.).

Connection Setup

  1. Check connection health first. Run assistant oauth status outlook. This checks whether the user's Outlook/Microsoft account is connected and the token is valid. Outlook Calendar shares the same OAuth connection as Outlook email — if the user already connected Outlook email, calendar access is included.
    • If the status output shows more than one active connection, you MUST pass --account <email> on every scripts/outlook-cal.ts invocation, matching the calendar the user is asking about. When the user references a calendar by name or company (e.g. "my Acme calendar"), map it to the connected account email before querying. Omitting --account with multiple connections silently queries one arbitrary account — an empty or partial result then looks like a genuinely free calendar when it is really the wrong account. Confirm the account field in each response matches the account you intended.
  2. If no connection is found or the status check fails: Load the vellum-oauth-integrations skill. The skill will evaluate whether managed or your-own mode is appropriate and guide the user accordingly.

Scheduling Playbook

When the user wants to schedule something:

  1. Always check availability first before proposing times. Use bun scripts/outlook-cal.ts availability to find free slots.
  2. Propose 2-3 available time options to the user.
  3. Once the user picks a time, create the event with bun scripts/outlook-cal.ts create.
  4. If adding other attendees, mention that they'll receive an invitation email.
Show full SKILL.md (310 more words)Show less

Date & Time Handling

  • Use ISO 8601 format for dates and times (e.g., 2024-01-15T09:00:00-05:00).
  • For all-day events, Outlook uses dateTime with an isAllDay flag — set the start and end as date-only values (e.g., 2024-01-15).
  • Always ask the user for their timezone if it's not already known from context or their profile.
  • When listing events, display times in the user's local timezone.
  • Timezone edge case: When dateTime already includes a UTC offset (e.g., 2024-01-15T09:00:00-05:00), do not send a separate timeZone parameter — the offset in the datetime string is authoritative and sending both can cause conflicts.

Confidence & Safety

Create and RSVP are medium-risk operations:

  • Create: The create subcommand gates on assistant ui confirm — it presents a confirmation dialog to the user and only proceeds if approved. Pass --skip-confirm when the user has already given explicit confirmation in the conversation.
  • RSVP: The rsvp subcommand gates on assistant ui confirm — it presents a confirmation dialog showing the event, current status, and new response. Pass --skip-confirm when the user has already given explicit confirmation in the conversation.

Error Recovery

When a calendar script fails with a token or authorization error:

  1. Try to reconnect silently. Run assistant oauth ping outlook. This often resolves expired tokens automatically.
  2. If reconnection fails, go straight to setup. Don't present options, ask which route the user prefers, or explain what went wrong technically. Just tell the user briefly (e.g., "Outlook Calendar needs to be reconnected - let me set that up") and immediately load the vellum-oauth-integrations skill. The user came to you to get something done, not to troubleshoot - make it seamless.
  3. Never try alternative approaches. Don't use curl, browser automation, or any workaround. If the scripts can't do it, the reconnection flow is the answer.
  4. Never expose error details. The user doesn't need to see error messages about tokens, OAuth, or API failures. Translate errors into plain language.

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, assets) in skills/outlook-calendar of vellum-ai/vellum-assistant.

  • SKILL.md
  • assets/icon.svg
  • scripts/lib/common.test.ts
  • scripts/lib/common.ts
  • scripts/lib/outlook-cal-client.ts
  • scripts/outlook-cal.ts

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Outlook Calendar next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Outlook Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outlook Calendar this skillvellum-ai/vellum-assistant1.4k—~1.7kAutomated safety check: PassMIT
Local Toolsfreestylefly/wesight946—~3.4kAutomated safety check: PassMIT
Outlooksigcli/sigcli293—~2.6kAutomated safety check: PassMIT
Outlook Emails Lawvablelawve-ai/awesome-legal-skills847—~672Automated safety check: PassAGPL-3.0
Outlook Calendar Automationdavepoon/buildwithclaude3.6k5 repos~2.4kAutomated safety check: PassMIT
Analyzing Outlook Pst For Email Forensicsmukul975/Anthropic-Cybersecurity-Skills34k—~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Local Tools

    freestylefly/wesight

    Access local system resources including Calendar on macOS and Windows.

    946 GitHub stars~3.4k tokensUpdated 9 days ago
    Auto-check passed
  • Outlook

    sigcli/sigcli

    Interact with Outlook email — read inbox, send emails, search messages, reply/forward, manage folders, download attachments.

    293 GitHub stars~2.6k tokensUpdated 13 days ago
    Productivity & AutomationAuto-check passed
  • Outlook Emails Lawvable

    lawve-ai/awesome-legal-skills

    Read, search, and download emails and attachments from Microsoft Outlook via OAuth2.

    847 GitHub stars~672 tokensUpdated 8 days ago
    Legal & ComplianceAuto-check passed
  • Outlook Calendar Automation

    davepoon/buildwithclaude

    Automate Outlook Calendar tasks via Rube MCP (Composio): create events, manage attendees, find meeting times, and handle invitations.

    3.6k GitHub starsUsed in 5 repos~2.4k tokens
    Productivity & AutomationAuto-check passed
  • Analyzing Outlook Pst For Email Forensics

    mukul975/Anthropic-Cybersecurity-Skills

    Parse Microsoft Outlook PST and OST files using libpff and pst-utils to extract message content, headers, attachments, deleted items, and MAPI metadata, including recovery of items from the…

    34k GitHub stars~3.2k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Microsoft Outlook

    zapier/connectors

    Official

    Agent-callable Microsoft Outlook tools — read and search mail, send/reply/forward, organize messages and folders, manage calendar events, and manage contacts.

    177 GitHub stars~4.6k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Questions about Outlook Calendar

What does Outlook Calendar do?

View Outlook Calendar events for any day, create and manage events, and check availability. Outlook Calendar is an agent skill from vellum-ai/vellum-assistant.

How do I install Outlook Calendar in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill outlook-calendar -a claude-code`. Or copy the skill folder (skills/outlook-calendar in vellum-ai/vellum-assistant) into .claude/skills/outlook-calendar in your project. Claude Code loads it when a task matches its description.

How do I install Outlook Calendar in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill outlook-calendar -a codex`. Or copy the skill folder (skills/outlook-calendar in vellum-ai/vellum-assistant) into .agents/skills/outlook-calendar in your project. Codex loads it when a task matches its description.

Can I use Outlook Calendar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill outlook-calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outlook-calendar, .gemini/skills/outlook-calendar, .github/skills/outlook-calendar and .opencode/skills/outlook-calendar in your project.

What does Outlook Calendar need to run?

Going by SKILL.md and its folder, Outlook Calendar needs TypeScript for the scripts in its folder and the command-line tools its instructions call (bun). Our summary lists: Node.js. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Outlook Calendar access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Outlook Calendar safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Outlook Calendar use?

Outlook Calendar is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Outlook Calendar use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Outlook Calendar?

Skills that share tags, products or a category with Outlook Calendar: Local Tools (freestylefly/wesight, 946 stars), Outlook (sigcli/sigcli, 293 stars), Outlook Emails Lawvable (lawve-ai/awesome-legal-skills, 847 stars) and Outlook Calendar Automation (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outlook Calendar?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.