Agent skill

Microsoft Teams

Microsoft Teams API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

Install Microsoft Teams

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a claude-code

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

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams --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/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/microsoft-teams .claude/skills/microsoft-teams && 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/

Paste into Claude Code

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .claude/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/microsoft-teams .agents/skills/microsoft-teams && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .agents/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/microsoft-teams .cursor/skills/microsoft-teams && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .cursor/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/CraftOS-dev/CraftBot.git --path skills/microsoft-teams

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/microsoft-teams .gemini/skills/microsoft-teams && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .gemini/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/microsoft-teams .github/skills/microsoft-teams && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .github/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot microsoft-teams --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/microsoft-teams .opencode/skills/microsoft-teams && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "microsoft-teams" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/microsoft-teams into .opencode/skills/microsoft-teams/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "microsoft-teams", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: microsoft-teams
GitHub stars: 392
Used in: 1 other repo
Token cost: ~4.4k tokens
SKILL.md length: 653 words
Files: 3
Skills in repo: 89
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Microsoft Teams API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

Works in 3 steps: Sign in or create an account at maton.ai → Go to maton.ai/settings → Copy your API key
Users want to list teams
SKILL.md covers Quick Start, Base URL, Authentication and Connection Management, plus 6 more sections
Calls python and curl; reaches gateway.maton.ai and ctrl.maton.ai; needs MATON_API_KEY

What it does

Microsoft Teams is an agent skill from CraftOS-dev/CraftBot. Microsoft Teams API integration with managed OAuth. Manage teams, channels, messages, and meetings via Microsoft Graph API. Use this skill when users want to list teams, create channels, send messages, schedule meetings, or access meeting recordings and transcripts. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).

Its SKILL.md is about 4.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `_meta.json`). Compatibility notes: Requires network access and valid Maton API key

It sits in Backend & APIs, covering Microservices, Third-party API integration and Calendar and scheduling. It works with Microsoft Teams and Microsoft 365. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

Users want to list teams
Create channels
Schedule meetings
Access meeting recordings and transcripts

Example prompts

“/microsoft-teams”

Requirements

Python 3
A credential in MATON_API_KEY
A credential in YOUR_API_KEY
Compatibility (from SKILL.md): Requires network access and valid Maton API key

Workflow steps

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

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. 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
Shell commands in SKILL.md call:
- python
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- gateway.maton.ai
- ctrl.maton.ai
- graph.microsoft.com
- teams.microsoft.com
- connect.maton.ai
Also links to:
- learn.microsoft.com
- maton.ai
- discord.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- MATON_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires network access and valid Maton API key
From compatibility in the SKILL.md frontmatter.

Context cost

Microsoft Teams loads about 4.4k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 653 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 653 words, ~4,366 tokens.

Download SKILL.mdSave it as .claude/skills/microsoft-teams/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: microsoft-teams
description: Microsoft Teams API integration with managed OAuth. Manage teams, channels, messages, and meetings via Microsoft Graph API. Use this skill when users want to list teams, create channels, send messages, schedule meetings, or access meeting recordings and transcripts. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility: Requires network access and valid Maton API key
metadata.author: maton
metadata.version: 1.0

Microsoft Teams

Access the Microsoft Teams API with managed OAuth authentication via Microsoft Graph. Manage teams, channels, messages, meetings, and access recordings and transcripts.

Quick Start

bash

# List user's joined teams
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/microsoft-teams/v1.0/me/joinedTeams')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/microsoft-teams/{native-api-path}

Replace {native-api-path} with the actual Microsoft Graph API endpoint path. The gateway proxies requests to graph.microsoft.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

bash

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Microsoft Teams OAuth connections at https://ctrl.maton.ai.

List Connections

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=microsoft-teams&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

bash

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'microsoft-teams'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

json

{
  "connection": {
    "connection_id": "fb0fdc4a-0b5a-40cf-8b92-3bdae848cde3",
    "status": "ACTIVE",
    "creation_time": "2026-02-17T09:51:21.074601Z",
    "last_updated_time": "2026-02-17T09:51:34.323814Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "microsoft-teams",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Microsoft Teams connections, specify which one to use with the Maton-Connection header:

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/microsoft-teams/v1.0/me/joinedTeams')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', 'fb0fdc4a-0b5a-40cf-8b92-3bdae848cde3')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Teams

List Joined Teams

bash

GET /microsoft-teams/v1.0/me/joinedTeams

Response:

json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams",
  "@odata.count": 1,
  "value": [
    {
      "id": "b643f103-870d-4f98-a23d-e6f164fae33e",
      "displayName": "carvedai.com",
      "description": null,
      "isArchived": false,
      "tenantId": "cb83c3f9-6d16-4cf3-bd8c-ab16b37932f9"
    }
  ]
}

Get Team

bash

GET /microsoft-teams/v1.0/teams/{team-id}

Channels

List Channels

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels

Response:

json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('...')/channels",
  "@odata.count": 1,
  "value": [
    {
      "id": "19:9fwtZjo3IM0D8bLdQqR-_oMFw1eUDlzWjPfIhNGhVd41@thread.tacv2",
      "createdDateTime": "2026-02-16T20:09:27.254Z",
      "displayName": "General",
      "description": null,
      "email": "carvedai.com473@carvedai.com",
      "membershipType": "standard",
      "isArchived": false
    }
  ]
}

List Private Channels

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels?$filter=membershipType eq 'private'

Get Channel

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}

Create Channel

bash

POST /microsoft-teams/v1.0/teams/{team-id}/channels
Content-Type: application/json

{
  "displayName": "New Channel",
  "description": "Channel description",
  "membershipType": "standard"
}

Response:

json

{
  "id": "19:3b3361df822044558a062bb1a4ac8357@thread.tacv2",
  "createdDateTime": "2026-02-17T20:24:33.9284462Z",
  "displayName": "Maton Test Channel",
  "description": "Channel created by Maton integration test",
  "membershipType": "standard",
  "isArchived": false
}

Update Channel

bash

PATCH /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}
Content-Type: application/json

{
  "description": "Updated description"
}

Returns 204 No Content on success. Note: The default "General" channel cannot be updated.

Delete Channel

bash

DELETE /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}

Returns 204 No Content on success.

Channel Members

List Channel Members

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/members

Response:

json

{
  "@odata.count": 1,
  "value": [
    {
      "@odata.type": "#microsoft.graph.aadUserConversationMember",
      "id": "MCMjMiMj...",
      "roles": ["owner"],
      "displayName": "Kevin Kim",
      "userId": "5f56d55b-2ffb-448d-982a-b52547431f71",
      "email": "richard@carvedai.com"
    }
  ]
}

Messages

List Channel Messages

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages

Send Message to Channel

bash

POST /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages
Content-Type: application/json

{
  "body": {
    "content": "Hello World"
  }
}

Response:

json

{
  "id": "1771359569239",
  "replyToId": null,
  "messageType": "message",
  "createdDateTime": "2026-02-17T20:19:29.239Z",
  "importance": "normal",
  "locale": "en-us",
  "from": {
    "user": {
      "id": "5f56d55b-2ffb-448d-982a-b52547431f71",
      "displayName": "Kevin Kim",
      "userIdentityType": "aadUser",
      "tenantId": "cb83c3f9-6d16-4cf3-bd8c-ab16b37932f9"
    }
  },
  "body": {
    "contentType": "text",
    "content": "Hello World"
  },
  "channelIdentity": {
    "teamId": "b643f103-870d-4f98-a23d-e6f164fae33e",
    "channelId": "19:9fwtZjo3IM0D8bLdQqR-_oMFw1eUDlzWjPfIhNGhVd41@thread.tacv2"
  }
}

Send HTML Message

bash

POST /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages
Content-Type: application/json

{
  "body": {
    "contentType": "html",
    "content": "<h1>Hello</h1><p>This is <strong>formatted</strong> content.</p>"
  }
}

Reply to Message

bash

POST /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
Content-Type: application/json

{
  "body": {
    "content": "This is a reply"
  }
}

List Message Replies

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Edit Message

bash

PATCH /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}
Content-Type: application/json

{
  "body": {
    "content": "Updated message content"
  }
}

Returns 204 No Content on success.

Team Members

List Team Members

bash

GET /microsoft-teams/v1.0/teams/{team-id}/members

Response:

json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('...')/members",
  "@odata.count": 1,
  "value": [
    {
      "@odata.type": "#microsoft.graph.aadUserConversationMember",
      "id": "MCMjMSMj...",
      "roles": ["owner"],
      "displayName": "Kevin Kim",
      "userId": "5f56d55b-2ffb-448d-982a-b52547431f71",
      "email": "richard@carvedai.com",
      "tenantId": "cb83c3f9-6d16-4cf3-bd8c-ab16b37932f9"
    }
  ]
}

Presence

Get User Presence

bash

GET /microsoft-teams/v1.0/me/presence

Response:

json

{
  "id": "5f56d55b-2ffb-448d-982a-b52547431f71",
  "availability": "Offline",
  "activity": "Offline",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  }
}

Availability values: Available, Busy, DoNotDisturb, Away, Offline

Get User Presence by ID

bash

GET /microsoft-teams/v1.0/users/{user-id}/presence

Returns presence information for a specific user by their ID.

Tabs

List Channel Tabs

bash

GET /microsoft-teams/v1.0/teams/{team-id}/channels/{channel-id}/tabs

Response:

json

{
  "@odata.count": 2,
  "value": [
    {
      "id": "ee0b3e8b-dfc8-4945-a45d-28ceaf787d92",
      "displayName": "Notes",
      "webUrl": "https://teams.microsoft.com/l/entity/..."
    },
    {
      "id": "3ed5b337-c2c9-4d5d-b7b4-84ff09a8fc1c",
      "displayName": "Files",
      "webUrl": "https://teams.microsoft.com/l/entity/..."
    }
  ]
}

Apps

List Installed Apps

bash

GET /microsoft-teams/v1.0/teams/{team-id}/installedApps

Online Meetings

Create Meeting

bash

POST /microsoft-teams/v1.0/me/onlineMeetings
Content-Type: application/json

{
  "subject": "Team Sync",
  "startDateTime": "2026-02-18T10:00:00Z",
  "endDateTime": "2026-02-18T11:00:00Z"
}

Response:

json

{
  "id": "MSo1ZjU2ZDU1Yi0yZmZi...",
  "subject": "Team Sync",
  "startDateTime": "2026-02-18T10:00:00Z",
  "endDateTime": "2026-02-18T11:00:00Z",
  "joinUrl": "https://teams.microsoft.com/l/meetup-join/...",
  "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/...",
  "meetingCode": "28636743235745",
  "joinMeetingIdSettings": {
    "joinMeetingId": "28636743235745",
    "passcode": "qh37NK9V",
    "isPasscodeRequired": true
  },
  "participants": {
    "organizer": {
      "upn": "richard@carvedai.com",
      "role": "presenter"
    }
  }
}

The joinUrl can be shared with attendees to join the meeting.

Get Meeting

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}

Find Meeting by Join URL

bash

GET /microsoft-teams/v1.0/me/onlineMeetings?$filter=JoinWebUrl eq '{encoded-join-url}'

Note: Microsoft Graph requires a filter to query meetings. You cannot list all meetings without filtering by JoinWebUrl.

List Calendar Events (includes scheduled meetings)

bash

GET /microsoft-teams/v1.0/me/calendar/events?$top=10

Scheduled Teams meetings appear as calendar events with isOnlineMeeting: true.

Delete Meeting

bash

DELETE /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}

Returns 204 No Content on success.

Create Meeting with Attendees

bash

POST /microsoft-teams/v1.0/me/onlineMeetings
Content-Type: application/json

{
  "subject": "Project Review",
  "startDateTime": "2026-02-18T14:00:00Z",
  "endDateTime": "2026-02-18T15:00:00Z",
  "participants": {
    "attendees": [
      {
        "upn": "attendee@example.com",
        "role": "attendee"
      }
    ]
  }
}

List Meeting Recordings

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/recordings

Returns a list of recordings for a meeting (available after the meeting has ended and recording was enabled).

Get Meeting Recording

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/recordings/{recording-id}

List Meeting Transcripts

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/transcripts

Returns a list of transcripts for a meeting (available after the meeting has ended and transcription was enabled).

Get Meeting Transcript

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/transcripts/{transcript-id}

Show full SKILL.md (267 more words)Show less

List Attendance Reports

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/attendanceReports

Returns attendance reports for a meeting (available after the meeting has ended).

Get Attendance Report

bash

GET /microsoft-teams/v1.0/me/onlineMeetings/{meeting-id}/attendanceReports/{report-id}

Chats

List User Chats

bash

GET /microsoft-teams/v1.0/me/chats

Get Chat

bash

GET /microsoft-teams/v1.0/chats/{chat-id}

List Chat Messages

bash

GET /microsoft-teams/v1.0/chats/{chat-id}/messages

Send Chat Message

bash

POST /microsoft-teams/v1.0/chats/{chat-id}/messages
Content-Type: application/json

{
  "body": {
    "content": "Hello in chat"
  }
}

Pagination

Microsoft Graph uses OData-style pagination with @odata.nextLink:

bash

GET /microsoft-teams/v1.0/me/joinedTeams?$top=10

Response includes pagination link when more results exist:

json

{
  "value": [...],
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/joinedTeams?$skiptoken=..."
}

Use the $top parameter to limit results per page.

OData Query Parameters

$top=10 - Limit results
$skip=20 - Skip results
$select=id,displayName - Select specific fields
$filter=membershipType eq 'private' - Filter results
$orderby=displayName - Sort results

Code Examples

JavaScript

javascript

const response = await fetch(
  'https://gateway.maton.ai/microsoft-teams/v1.0/me/joinedTeams',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const data = await response.json();

Python

python

import os
import requests

response = requests.get(
    "https://gateway.maton.ai/microsoft-teams/v1.0/me/joinedTeams",
    headers={"Authorization": f"Bearer {os.environ['MATON_API_KEY']}"},
)
data = response.json()

Send Message Example (Python)

python

import os
import requests

team_id = "your-team-id"
channel_id = "your-channel-id"

response = requests.post(
    f"https://gateway.maton.ai/microsoft-teams/v1.0/teams/{team_id}/channels/{channel_id}/messages",
    headers={
        "Authorization": f"Bearer {os.environ['MATON_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"body": {"content": "Hello from Maton!"}},
)
data = response.json()

Notes

Uses Microsoft Graph API v1.0
Messages are sent as the authenticated user (not as a bot) - the from.user field shows the actual user identity
Team IDs are GUIDs (e.g., b643f103-870d-4f98-a23d-e6f164fae33e)
Channel IDs include thread suffix (e.g., 19:9fwtZjo3IM0D8bLdQqR-_oMFw1eUDlzWjPfIhNGhVd41@thread.tacv2)
Message IDs are timestamps (e.g., 1771359569239)
Message body content types: text (default) or html
Channel membership types: standard, private, shared
The default "General" channel cannot be updated or deleted
Only me endpoint is supported for listing joined teams (not arbitrary user IDs)
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

Status	Meaning
400	Missing Microsoft Teams connection or invalid request
401	Invalid or missing Maton API key
403	Insufficient permissions for the requested resource
404	Team, channel, or message not found
429	Rate limited (Microsoft Graph throttling)
4xx/5xx	Passthrough error from Microsoft Graph API

Resources

Files

SKILL.md and 2 other files in skills/microsoft-teams of CraftOS-dev/CraftBot.

SKILL.md
LICENSE.txt
_meta.json

Open the folder on GitHubat commit b50970c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in CraftOS-dev/CraftBot, which our catalogue first saw on October 7, 2026.

LeoYeAI/openclaw-master-skillsskills/microsoft-teams

Compare with similar skills

Microsoft Teams 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.

Microsoft Teams compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Microsoft Teams this skillCraftOS-dev/CraftBot	392	1 repos	~4.4k	Automated safety check: Pass	MIT	today
One NoteLeoYeAI/openclaw-master-skills	2.2k	—	~4.8k	Automated safety check: Pass	MIT	2 mo ago
Active CampaignLeoYeAI/openclaw-master-skills	2.2k	—	~4.1k	Automated safety check: Pass	MIT	2 mo ago
Acuity SchedulingLeoYeAI/openclaw-master-skills	2.2k	—	~4.1k	Automated safety check: Pass	MIT	2 mo ago
BrevoLeoYeAI/openclaw-master-skills	2.2k	—	~4.8k	Automated safety check: Pass	MIT	2 mo ago
ClickfunnelsLeoYeAI/openclaw-master-skills	2.2k	—	~4.2k	Automated safety check: Pass	MIT	2 mo ago

Similar skills

One Note
LeoYeAI/openclaw-master-skills
OneNote API integration with managed OAuth via Microsoft Graph.
2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Active Campaign
LeoYeAI/openclaw-master-skills
ActiveCampaign API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Acuity Scheduling
LeoYeAI/openclaw-master-skills
Acuity Scheduling API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Brevo
LeoYeAI/openclaw-master-skills
Brevo API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Clickfunnels
LeoYeAI/openclaw-master-skills
ClickFunnels API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Confluence
LeoYeAI/openclaw-master-skills
Confluence API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed

Questions about Microsoft Teams

What does Microsoft Teams do?

Microsoft Teams API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot. Microsoft Teams is an agent skill from CraftOS-dev/CraftBot. Microsoft Teams API integration with managed OAuth.

When should I use Microsoft Teams?

Microsoft Teams fits situations like: users want to list teams; create channels; schedule meetings; access meeting recordings and transcripts.

How do I install Microsoft Teams in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a claude-code`. Or copy the skill folder (skills/microsoft-teams in CraftOS-dev/CraftBot) into .claude/skills/microsoft-teams in your project. Claude Code loads it when a task matches its description.

How do I install Microsoft Teams in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill microsoft-teams -a codex`. Or copy the skill folder (skills/microsoft-teams in CraftOS-dev/CraftBot) into .agents/skills/microsoft-teams in your project. Codex loads it when a task matches its description.

Can I use Microsoft Teams 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 CraftOS-dev/CraftBot --skill microsoft-teams -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/microsoft-teams, .gemini/skills/microsoft-teams, .github/skills/microsoft-teams and .opencode/skills/microsoft-teams in your project.

What does Microsoft Teams need to run?

Going by SKILL.md and its folder, Microsoft Teams needs the command-line tools its instructions call (python and curl) and credentials named MATON_API_KEY. Our summary lists: Python 3; A credential in MATON_API_KEY; A credential in YOUR_API_KEY. Compatibility (from SKILL.md): Requires network access and valid Maton API key.

Does Microsoft Teams access the network?

SKILL.md names 8 domains. In commands or code: gateway.maton.ai, ctrl.maton.ai, graph.microsoft.com, teams.microsoft.com and connect.maton.ai; the agent is likely to contact these when it follows the instructions. As links in the text: learn.microsoft.com, maton.ai and discord.com. This is read from the text; nothing was executed.

Is Microsoft Teams 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. Review the folder before installing.

What licence does Microsoft Teams use?

Microsoft Teams is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Microsoft Teams use?

About 4.4k tokens (SKILL.md is roughly 17k 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 Microsoft Teams?

Skills that share tags, products or a category with Microsoft Teams: One Note (LeoYeAI/openclaw-master-skills, 2.2k stars), Active Campaign (LeoYeAI/openclaw-master-skills, 2.2k stars), Acuity Scheduling (LeoYeAI/openclaw-master-skills, 2.2k stars) and Brevo (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Microsoft Teams?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Microsoft Teams

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Microsoft Teams

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

Teams

List Joined Teams

Get Team

Channels

List Channels

List Private Channels

Get Channel

Create Channel

Update Channel

Delete Channel

Channel Members

List Channel Members

Messages

List Channel Messages

Send Message to Channel

Send HTML Message

Reply to Message

List Message Replies

Edit Message

Team Members

List Team Members

Presence

Get User Presence

Get User Presence by ID

Tabs

List Channel Tabs

Apps

List Installed Apps

Online Meetings

Create Meeting

Get Meeting

Find Meeting by Join URL

List Calendar Events (includes scheduled meetings)

Delete Meeting

Create Meeting with Attendees

List Meeting Recordings

Get Meeting Recording

List Meeting Transcripts

Get Meeting Transcript

List Attendance Reports

Get Attendance Report

Chats

List User Chats

Get Chat

List Chat Messages

Send Chat Message

Pagination

OData Query Parameters

Code Examples

JavaScript

Python