
microsoft-teams
Read and search Microsoft Teams through the signed-in client.
- version
- 0.1.0
- GitHub stars
- 347
Install
/plugin install microsoft-teams@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Microsoft Teams
Read Teams through the user's signed-in client over the Chrome DevTools Protocol
(CDP). The client's session does the authentication, so no tokens, Graph
permissions, or admin consent are involved. Run every command as
node <skill-dir>/scripts/teams_cdp.mjs <command> (Node 22+); without arguments
it prints usage and exit codes.
Rules
- Read only. Send, react, edit, or delete only when the user asks.
- Never print, store, or extract tokens or cookies. Make requests from inside the signed-in page or frame.
- Ask before restarting Teams; a restart ends calls.
- Keep exports in a private directory outside the skill, such as
${XDG_CACHE_HOME:-$HOME/.cache}/teams-exportwith mode 700. - UI commands (
search,read,sidebar) need the window handed over: on screen, no call, nobody typing. Opening a conversation marks it read, so name it to the user first. One agent drives the UI at a time.
Workflow
- Check access. Use a working Teams MCP server or Graph access instead of
this skill. Otherwise run
status; exit 3 means no debug endpoint or Teams page, so follow references/connect.md. - Find the conversation.
cache-list --kind channel --name Designlists matching conversations with their ids and teams. - Read the cache.
cache-read "<name-or-id>" --from selfreturns cached messages. This step is done when the output covers the request, or when it returns ahintor stops short of the dates needed. - Search for the rest.
search '<query>' --in "<conversation>"covers history the cache lacks. On exit 5 (call) or 6 (window off screen), wait for the user and retry. - Read an open view only for content neither source returns: open the
conversation, then
readorread --all. - Fetch files.
sp-download <private-dir> <path>takes the attachment paths fromcache-reador files listed bysp-list /teams/<Site>.
Cache commands
The cache commands read Teams' IndexedDB. They never touch the UI, mark nothing read, and work while the window is hidden.
cache-listreturns id, kind, name, and team for each conversation. Filter with--kind(chat, channel, meeting, community, other),--name, and--team.cache-read <name-or-id>returns messages oldest first: id,threadId,isRoot, time, author, subject, and attachments with SharePointpaths. Filters:--from self|"Display Name",--thread ID,--sinceand--until(ISO),--limit(default 500, newest kept),--all-typesfor call records.--bodyadds text, capped by--max-chars(default 4000).- A name that matches nothing or several conversations exits 4 and lists
candidates. Every team has a General channel; add
--teamor use the id. - Results are what this client has synced. Most conversations have nothing
cached, and cached ones usually hold recent history only, so
completenessis alwaysunknown. Deleted messages are skipped and counted.
Schema and limits: references/cache.md.
UI search
--inscopes to one chat or channel; without it, search spans every conversation. A new query clears the filter, so the script reapplies it.from:"Name"limits results to one sender. Option labels list the channel and then its team;--team TEXTpicks among same-named channels.- Each page holds up to 25 cards. The script follows Next up to
--max-pages(default 10) and setsmore: truewhen it stops early. - Counts are a lower bound. Cards carry no thread id; use
cache-readfor thread ids.
Open views and files
readreturns the messages loaded in the open chat, channel, or thread.read --allscrolls a channel or thread toward its start; itssettledAtTopflag means loading stopped, not that the first message was reached.sp-list /teams/<Site>lists library files with author and times.sp-downloadwrites mode-600 files under the output directory, refuses to overwrite without--force, and exits 1 if any download fails.- Convert
.docxwithpandoc -f docx -t gfm; for.pptx, join the<a:t>runs in eachppt/slides/slideN.xml. evalruns JavaScript in the page or a--target <url-regex>frame and skips every guard. Selectors and UI quirks: references/teams-dom.md.
Unverified: read --all, --team, in-page search submission, and sending.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/microsoft-teams
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
- typescript-best-practicesv0.1.6
- unslopv0.1.7
- verification-harnessv0.1.5
- whyv0.1.6
- ai-tools-architectv0.1.21
- architectv0.1.7