Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bighardperson avatar

Outlook Calendar

  • 8 installs
  • 33 repo stars
  • Updated April 26, 2026
  • bighardperson/computer-science-skills-collection

outlook-calendar is a Claude skill that reads a Microsoft 365 Outlook calendar so an agent can answer schedule, meeting, and task questions.

About

outlook-calendar reads a Microsoft 365 Outlook calendar so an agent can answer questions about schedule, meetings, and tasks. It logs in with MFA via a Playwright script, caches cookies and a bearer token, then reads events for a day, week, month, or custom range. It triggers whenever a user asks about their agenda and converts UTC times to local time before answering.

  • Reads a Microsoft 365 Outlook calendar for day, week, month, or custom ranges
  • Handles MFA login via Playwright and caches cookies plus a bearer token
  • Stores credentials outside the skill directory in ~/.outlook/

Outlook Calendar by the numbers

  • 8 all-time installs (skills.sh)
  • Ranked #2,242 of 3,280 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
At a glance

outlook-calendar capabilities & compatibility

Free skill; requires Microsoft 365 account credentials and Authenticator MFA.

Capabilities
planning · project management
Works with
outlook
Use cases
planning · project management
Pricing
Free
From the docs

What outlook-calendar says it does

python owa_calendar.py --today # 今天
SKILL.md
注意:API 返回时间为 UTC,需 +8 转换为上海时间。
SKILL.md
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill outlook-calendar

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs8
repo stars33
Last updatedApril 26, 2026
Repositorybighardperson/computer-science-skills-collection

What it does

Answer a user's schedule and meeting questions by reading their Microsoft 365 Outlook calendar for a chosen date range.

Who is it for?

Reading an enterprise Microsoft 365 Outlook calendar to summarize meetings and schedule.

When should I use this skill?

A user asks about their schedule, meetings, agenda, or tasks in Outlook.

What you get

A summarized answer about the user's meetings, agenda, or total meeting hours for a requested period.

  • A summary of calendar events, total meeting hours, or agenda for a date range

By the numbers

  • Cookie validity is typically 1-7 days
  • Bearer token cache is valid 1 hour

Files

SKILL.mdMarkdownGitHub ↗

Outlook 日历技能

触发条件

只要用户问任何涉及日程、会议、安排、日历、工作、任务、事情的问题,必须调用此技能。

  • "明天有什么安排" / "这周有什么会" / "本月日程"
  • "帮我看看日历" / "我今天几点有会"
  • "这个月会议一共多少小时"
  • "我下周有啥工作" / "明天要做啥" / "这周有什么事"
  • "下周安排" / "有啥任务" / "日程表看一下"
  • 任何时间 + 安排/会议/事件/工作/任务/事情的组合问法

首次配置

敏感信息(账号密码、Cookie、Token)存放在 ~/.outlook/不在 skill 目录内

1. 创建配置文件

创建 ~/.outlook/config.json,内容如下:

{
  "email": "your@company.com",
  "password": "your_password",
  "cookie_file": "/root/.outlook/cookies.json",
  "cookie_max_age_days": 7,
  "mfa_type": "authenticator_number_match"
}

2. 安装依赖

pip install playwright requests
playwright install chromium

3. 首次登录(MFA)

cd ~/.agents/skills/outlook-calendar
python login.py

脚本输出 [NUMBER:XX] 时,在 Microsoft Authenticator App 输入数字 XX 并批准,Cookie 自动保存到 ~/.outlook/cookies.json

调用步骤

第一步:读取日历

cd ~/.agents/skills/outlook-calendar
python owa_calendar.py --today          # 今天
python owa_calendar.py --tomorrow       # 明天
python owa_calendar.py --week           # 本周
python owa_calendar.py --month 2026-03  # 指定月份
python owa_calendar.py --range 2026-03-01 2026-03-31  # 自定义范围

第二步:处理 AUTH_FAILED

若输出 [AUTH_FAILED],Cookie 或 Token 过期,重新登录:

python login.py

第三步:整理输出

按用户问题整理回答:列出事件、统计总时长、按周分组等。 注意:API 返回时间为 UTC,需 +8 转换为上海时间。

文件结构

skill 目录(无敏感信息):
~/.agents/skills/outlook-calendar/
├── SKILL.md
├── login.py          # MFA 登录,保存 Cookie 到 ~/.outlook/
└── owa_calendar.py   # 日历读取(Token 模式)

敏感数据目录:
~/.outlook/
├── config.json       # 账号密码(自行创建)
├── cookies.json      # 登录 Cookie(login.py 自动生成)
└── token.json        # Bearer Token 缓存(自动生成,1h 有效)

MFA 说明

  • 类型:Authenticator 数字匹配
  • Cookie 有效期:通常 1-7 天,过期重跑 login.py
  • 多次失败会触发微软限速,等 15 分钟再试

Related skills

FAQ

How does outlook-calendar handle login?

It uses login.py with Playwright for Authenticator number-match MFA, then caches cookies in ~/.outlook/cookies.json.

Does it convert meeting times?

Yes; the API returns UTC and the skill adds 8 hours to convert to Shanghai local time before answering.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.