teams-api 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +26 -11
  2. package/SKILL.md +5 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,9 +4,9 @@ AI-native Microsoft Teams integration — read conversations, send messages, and
4
4
 
5
5
  Designed for autonomous AI agents that need to interact with Teams: read messages, reply to people, monitor conversations, and participate in team workflows.
6
6
 
7
- [<img src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522teams%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522teams-api%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522TEAMS_LOGIN%2522%253A%2522true%2522%257D%257D)
8
- [<img src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522teams%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522teams-api%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522TEAMS_LOGIN%2522%253A%2522true%2522%257D%257D)
9
- [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=teams&config=%7B%22name%22%3A%22teams%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22teams-api%40latest%22%5D%2C%22env%22%3A%7B%22TEAMS_LOGIN%22%3A%22true%22%7D%7D)
7
+ [<img src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522teams%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522-p%2522%252C%2522teams-api%2540latest%2522%252C%2522teams-api-mcp%2522%255D%252C%2522env%2522%253A%257B%2522TEAMS_LOGIN%2522%253A%2522true%2522%257D%257D)
8
+ [<img src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522teams%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522-p%2522%252C%2522teams-api%2540latest%2522%252C%2522teams-api-mcp%2522%255D%252C%2522env%2522%253A%257B%2522TEAMS_LOGIN%2522%253A%2522true%2522%257D%257D)
9
+ [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=teams&config=%7B%22name%22%3A%22teams%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22-p%22%2C%22teams-api%40latest%22%2C%22teams-api-mcp%22%5D%2C%22env%22%3A%7B%22TEAMS_LOGIN%22%3A%22true%22%7D%7D)
10
10
  [![npm version](https://img.shields.io/npm/v/teams-api?style=flat-square)](https://www.npmjs.com/package/teams-api)
11
11
  [![MCP Registry](https://img.shields.io/badge/MCP_Registry-teams--api-green?style=flat-square)](https://registry.modelcontextprotocol.io)
12
12
 
@@ -25,6 +25,21 @@ Designed for autonomous AI agents that need to interact with Teams: read message
25
25
 
26
26
  The quickest way to get started is to click one of the install badges above, or follow the instructions for your editor below.
27
27
 
28
+ #### Install as an agent skill
29
+
30
+ The [SKILL.md](SKILL.md) teaches AI agents _how_ to use the MCP tools (when to call which tool, typical workflows, parameter guidance). Install it with the [`skills` CLI](https://github.com/vercel-labs/skills):
31
+
32
+ ```bash
33
+ npx -y skills add Maxim-Mazurok/teams-api
34
+ ```
35
+
36
+ This copies the skill into your agent's skills directory (Claude Code, Cursor, GitHub Copilot, Codex, and [many more](https://www.npmjs.com/package/skills#supported-agents)).
37
+
38
+ > [!NOTE]
39
+ > The skill is optional — the MCP tools work without it. The skill just gives agents extra context about when and how to use each tool.
40
+
41
+ #### Editor-specific instructions
42
+
28
43
  <details>
29
44
  <summary><strong>VS Code / VS Code Insiders</strong></summary>
30
45
 
@@ -36,10 +51,10 @@ Click the badge at the top of this README, or press `Cmd+Shift+X` / `Ctrl+Shift+
36
51
 
37
52
  ```bash
38
53
  # VS Code
39
- code --add-mcp '{"name":"teams","command":"npx","args":["-y","teams-api@latest"],"env":{"TEAMS_LOGIN":"true"}}'
54
+ code --add-mcp '{"name":"teams","command":"npx","args":["-y","-p","teams-api@latest","teams-api-mcp"],"env":{"TEAMS_LOGIN":"true"}}'
40
55
 
41
56
  # VS Code Insiders
42
- code-insiders --add-mcp '{"name":"teams","command":"npx","args":["-y","teams-api@latest"],"env":{"TEAMS_LOGIN":"true"}}'
57
+ code-insiders --add-mcp '{"name":"teams","command":"npx","args":["-y","-p","teams-api@latest","teams-api-mcp"],"env":{"TEAMS_LOGIN":"true"}}'
43
58
  ```
44
59
 
45
60
  **Option 3 — Manual config:**
@@ -51,7 +66,7 @@ Add to your VS Code MCP config (`.vscode/mcp.json` or User Settings):
51
66
  "mcpServers": {
52
67
  "teams": {
53
68
  "command": "npx",
54
- "args": ["-y", "teams-api@latest"],
69
+ "args": ["-y", "-p", "teams-api@latest", "teams-api-mcp"],
55
70
  "env": {
56
71
  "TEAMS_LOGIN": "true"
57
72
  }
@@ -72,7 +87,7 @@ Click the **Install in Cursor** badge at the top, or add to `~/.cursor/mcp.json`
72
87
  "mcpServers": {
73
88
  "teams": {
74
89
  "command": "npx",
75
- "args": ["-y", "teams-api@latest"],
90
+ "args": ["-y", "-p", "teams-api@latest", "teams-api-mcp"],
76
91
  "env": {
77
92
  "TEAMS_LOGIN": "true"
78
93
  }
@@ -93,7 +108,7 @@ Add to `claude_desktop_config.json` ([how to find it](https://modelcontextprotoc
93
108
  "mcpServers": {
94
109
  "teams": {
95
110
  "command": "npx",
96
- "args": ["-y", "teams-api@latest"],
111
+ "args": ["-y", "-p", "teams-api@latest", "teams-api-mcp"],
97
112
  "env": {
98
113
  "TEAMS_LOGIN": "true"
99
114
  }
@@ -108,7 +123,7 @@ Add to `claude_desktop_config.json` ([how to find it](https://modelcontextprotoc
108
123
  <summary><strong>Claude Code</strong></summary>
109
124
 
110
125
  ```bash
111
- claude mcp add teams -- npx -y teams-api@latest
126
+ claude mcp add teams -- npx -y -p teams-api@latest teams-api-mcp
112
127
  ```
113
128
 
114
129
  Then set the environment variable `TEAMS_LOGIN=true` in your shell before starting Claude Code. The server will ask for your email interactively on first use.
@@ -125,7 +140,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
125
140
  "mcpServers": {
126
141
  "teams": {
127
142
  "command": "npx",
128
- "args": ["-y", "teams-api@latest"],
143
+ "args": ["-y", "-p", "teams-api@latest", "teams-api-mcp"],
129
144
  "env": {
130
145
  "TEAMS_LOGIN": "true"
131
146
  }
@@ -333,7 +348,7 @@ Use this only if you already have tokens from another flow or need to avoid brow
333
348
  "mcpServers": {
334
349
  "teams": {
335
350
  "command": "npx",
336
- "args": ["-y", "teams-api@latest"],
351
+ "args": ["-y", "-p", "teams-api@latest", "teams-api-mcp"],
337
352
  "env": {
338
353
  "TEAMS_TOKEN": "<paste-skype-token-here>",
339
354
  "TEAMS_BEARER_TOKEN": "<optional-api-spaces-skype-bearer-token>",
package/SKILL.md CHANGED
@@ -1,3 +1,8 @@
1
+ ---
2
+ name: teams-api
3
+ description: Interact with Microsoft Teams — read messages, send replies, list conversations, search people, and look up team members. Use when an AI agent needs to participate in Teams workflows.
4
+ ---
5
+
1
6
  # teams-api MCP Skill
2
7
 
3
8
  Use this skill when you need to interact with Microsoft Teams — reading messages, sending replies, listing conversations, or looking up team members.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "teams-api",
3
- "version": "0.3.0",
3
+ "version": "0.3.2",
4
4
  "description": "AI-native Microsoft Teams integration — read conversations, send messages, manage members via the Teams Chat Service REST API",
5
5
  "type": "commonjs",
6
6
  "repository": {