What permissions are required for the scraper to work?

Your terminal or Claude Code environment must be granted Accessibility permissions in macOS System Preferences to allow the AppleScript to control the Teams UI.

How does it handle duplicate messages between scrapes?

The skill uses a deterministic hashing algorithm to create stable IDs for every message. It compares these IDs against existing local history to ensure only truly new messages are added.

Where is the extracted chat data stored?

Data is persisted locally in the `~/.config/teams-scrape/` directory as structured JSON files, organized by the name of the chat or channel.

Does this skill work with the Teams web app?

No, this skill is specifically designed for the Microsoft Teams desktop app on macOS as it relies on AppleScript and System Events for navigation.

Can it capture reactions and replies?

Yes, the parser is designed to identify reaction types, counts, and reply-to hierarchies, preserving the original context of the conversation.

Teams Chat Scraper

Name: Teams Chat Scraper
Author: nathanvale

bynathanvale

•

Collaboration Tools

Extracts and persists Microsoft Teams chat history into structured JSON with deterministic new message detection.

The Teams Chat Scraper skill enables Claude to programmatically navigate the Microsoft Teams desktop app to capture and organize chat data from direct messages, channels, and meetings. By combining AppleScript automation with a specialized TypeScript CLI, it transforms raw clipboard data into a durable, structured JSON format while maintaining a local history to detect only new messages since the last run. This tool is particularly useful for developers who need to archive project-specific discussions, track meeting notes, or bridge communication gaps between Teams and their development environment without manual copy-pasting.

Key Features

01Automated navigation to specific DMs or channels via AppleScript

02Comprehensive parsing of reactions, replies, mentions, and attachments

03Deterministic new message detection using stable message IDs

04Structured JSON storage with automatic kebab-case file naming

05Atomic file operations to ensure data integrity during persistence

061 GitHub stars

Use Cases

01Extracting meeting chat logs to generate summaries or action items

02Tracking new updates or specific mentions in a high-volume team channel

03Archiving project-specific chat history for documentation and search

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nathanvale/side-quest-marketplace teams-scrape

For use in Claude.ai and ChatGPT

Download Skill