Webex

MCP办公协作

提供方 未标注

办公协作 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

用于 Cisco Webex Messaging 的 MCP 服务器:搜索空间和消息、发送消息,以及管理空间、成员关系、人员、团队和 Webhook。通过 stdio 在本地运行;支持机器人令牌和 OAuth 2.0,并自动刷新令牌。

一句话选型结论

按资料字段整理

Webex 属于办公协作类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

通讯

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
# Run via npx (recommended) npx -y @yuryev89/webex-mcp@latest --token YOUR_ACCESS_TOKEN # Or install globally npm install -g @yuryev89/webex-mcp webex-mcp --token YOUR_ACCESS_TOKEN

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Webex当前 未标注 stdio · 本地进程 本地部署 有 2026-11-20
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-11-20上游最后核验时间

详细介绍

14.2 KB
来自项目仓库与上游目录的原文,未做删改

webex-mcp

Maintainers: see Publishing a release for GitHub Releases and npm setup.

> MCP server for Cisco Webex Messaging — connect AI assistants to Webex spaces, messages, and people.

Minimal MCP server that exposes Webex messaging tools over stdio. Works with Cursor, Claude Desktop, Codex, Claude Code, OpenCode, and other MCP clients.

Features

  • Full core Webex Messaging API coverage: spaces, messages, memberships, people, teams, webhooks, attachment actions, and file downloads
  • Received attachments for agents: images inline, text paged inline, ZIP/JAR listings, and saving any file to local disk
  • Search spaces and messages by keyword (client-side scan)
  • Direct calls to the Webex REST API over fetch (no Webex SDK), with rate-limit retries and pagination
  • OAuth 2.0 Integration login with automatic token refresh

Requirements

  • Node.js >= 22
  • Webex Bot access token or Webex Integration (OAuth) — developer.webex.com

Quick start

Option A — Bot token```bash

Run via npx (recommended)

npx -y @yuryev89/webex-mcp@latest --token YOUR_ACCESS_TOKEN

Or install globally

npm install -g @yuryev89/webex-mcp
webex-mcp --token YOUR_ACCESS_TOKEN


### Option B — OAuth Integration```bash
# 1. Set credentials (or use a .env file in your working directory)
export WEBEX_CLIENT_ID="your-client-id"
export WEBEX_CLIENT_SECRET="your-client-secret"

# 2. Authenticate once (opens browser)
npx -y @yuryev89/webex-mcp@latest login

# 3. Start MCP server (reads saved tokens, auto-refreshes)
npx -y @yuryev89/webex-mcp@latest

Cursor configuration

Bot token```json

{
"mcpServers": {
"webex": {
"command": "bash",
"args": [
"-lc",
"npx -y @yuryev89/webex-mcp@latest --token \"$WEBEX_ACCESS_TOKEN\""
],
"env": {
"WEBEX_ACCESS_TOKEN": "YOUR_BOT_ACCESS_TOKEN"
}
}
}
}


### OAuth Integration```json
{
  "mcpServers": {
    "webex": {
      "command": "npx",
      "args": ["-y", "@yuryev89/webex-mcp@latest"],
      "env": {
        "WEBEX_CLIENT_ID": "YOUR_CLIENT_ID",
        "WEBEX_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Run npx -y @yuryev89/webex-mcp@latest login once before starting Cursor (with WEBEX_CLIENT_ID and WEBEX_CLIENT_SECRET set).

Codex configuration

Add one of the following configurations to ~/.codex/config.toml (merge it with any existing configuration).

Bot token```toml

[mcp_servers.webex]
command = "npx"
args = ["-y", "@yuryev89/webex-mcp@latest"]

[mcp_servers.webex.env]
WEBEX_ACCESS_TOKEN = "YOUR_BOT_ACCESS_TOKEN"


### OAuth Integration

Complete Option B — OAuth Integration first, then use:```toml
[mcp_servers.webex]
command = "npx"
args = ["-y", "@yuryev89/webex-mcp@latest"]

[mcp_servers.webex.env]
WEBEX_CLIENT_ID = "YOUR_CLIENT_ID"
WEBEX_CLIENT_SECRET = "YOUR_CLIENT_SECRET"

Alternatively, keep credentials in your shell environment and replace the [mcp_servers.webex.env] table with env_vars = ["WEBEX_ACCESS_TOKEN"] inside [mcp_servers.webex] (or ["WEBEX_CLIENT_ID", "WEBEX_CLIENT_SECRET"] for OAuth). Start Codex from that shell.

Run codex mcp list to verify registration, then use /mcp in Codex to inspect the active server.

Reference: Codex MCP documentation.

Claude Code configuration

The following commands register Webex for your user account across projects. Choose one authentication mode.

Bot token```bash

claude mcp add --scope user \
--env WEBEX_ACCESS_TOKEN=YOUR_BOT_ACCESS_TOKEN \
--transport stdio webex -- npx -y @yuryev89/webex-mcp@latest


### OAuth Integration

Complete Option B — OAuth Integration first, then register:```bash
claude mcp add --scope user \
  --env WEBEX_CLIENT_ID=YOUR_CLIENT_ID \
  --env WEBEX_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  --transport stdio webex -- npx -y @yuryev89/webex-mcp@latest

Run claude mcp list or claude mcp get webex to check the connection. Inside Claude Code, use /mcp to inspect status and tools. To switch modes, remove the existing entry with claude mcp remove --scope user webex, then register it again.

Reference: Claude Code MCP documentation.

OpenCode configuration

Merge one of these examples into opencode.json in your project, or ~/.config/opencode/opencode.json for all projects.

Bot token```json

{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"webex": {
"type": "local",
"command": ["npx", "-y", "@yuryev89/webex-mcp@latest"],
"enabled": true,
"environment": {
"WEBEX_ACCESS_TOKEN": "{env:WEBEX_ACCESS_TOKEN}"
}
}
}
}


Set `WEBEX_ACCESS_TOKEN` in your environment before launching OpenCode; `{env:...}` reads that variable.

### OAuth Integration

Complete Option B — OAuth Integration first, then use:```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "webex": {
      "type": "local",
      "command": ["npx", "-y", "@yuryev89/webex-mcp@latest"],
      "enabled": true,
      "environment": {
        "WEBEX_CLIENT_ID": "{env:WEBEX_CLIENT_ID}",
        "WEBEX_CLIENT_SECRET": "{env:WEBEX_CLIENT_SECRET}"
      }
    }
  }
}

Keep WEBEX_CLIENT_ID and WEBEX_CLIENT_SECRET exported when launching OpenCode. Run opencode mcp list to check the server.

References: OpenCode MCP documentation and configuration.

Client setup notes

  • Each client starts the server as a local stdio process; no separate server terminal or HTTP URL is needed.
  • OAuth login is handled by npx -y @yuryev89/webex-mcp@latest login. Run it under the same OS user and token-store configuration as the client. Client-native MCP OAuth login commands do not replace this step.
  • For OAuth, remove WEBEX_ACCESS_TOKEN from the client configuration, inherited environment, and any loaded .env: a static token takes precedence over saved OAuth tokens.
  • Replace credential placeholders locally. Keep real credentials out of version control; CLI arguments may also be retained in shell history.
  • Ensure Node.js and npx are available to the client, then restart it after configuration changes.
  • Try: "Use Webex to list my spaces." For a message search, identify a space first; webex_search_messages searches one space at a time.

CLI options

Option / Command Description Default
--token Webex access token (Bot mode) $WEBEX_ACCESS_TOKEN
--fedramp Use FedRAMP endpoint false
--debug Log startup to stderr false
login OAuth browser login, save tokens —
logout Remove stored OAuth tokens —
auth-status Show OAuth expiry metadata —

Tools

Spaces

Tool Description
webex_list_spaces List spaces (rooms) for the authenticated user
webex_search_spaces Search spaces by title/name (case-insensitive)
webex_get_space Get space details by ID
webex_create_space Create a new space
webex_update_space Update a space
webex_delete_space Delete a space
webex_get_space_meeting_info Get meeting details for a space

Messages

Tool Description
webex_get_messages List messages in a space or get one by ID (includeFileDetails adds attachment names/types/sizes); optional compact output
webex_search_messages Keyword search within a single space; optional compact output
webex_get_thread_context Get a thread root plus up to 500 replies using a root or reply ID
webex_create_message Send text and/or file attachments to a space or DM
webex_update_message Update an existing message
webex_delete_message Delete a message
webex_list_direct_messages List messages in a 1:1 direct room (includeFileDetails as above)
webex_create_attachment_action Submit an attachment card action
webex_get_attachment_action Get attachment action details

Compact responses and thread context

For webex_get_messages, webex_search_messages, webex_list_direct_messages,
and webex_get_thread_context, set outputMode: "compact" to minimize JSON
and return one message text representation instead of both text and markdown.
The default outputMode: "full" preserves existing output for current clients.
maxTextChars (100–10,000, default 1,200) bounds text per message when
compact. Truncated text is flagged with textTruncated and originalChars.
Compact output replaces attachment URLs with counts and, when
includeFileDetails is enabled, attachment metadata. Use full mode for
download URLs or unabridged text.

webex_get_thread_context accepts roomId, messageId (root or reply),
and maxReplies (default 100, max 500). It resolves the root, collects
thread replies over multiple Webex pages and returns hasMore if the
result was capped. Thread access is restricted to the supplied space.

Sending file attachments

Use webex_create_message with files for publicly accessible HTTP(S) URLs:```json
{
"roomId": "SPACE_ID",
"text": "Here is the report",
"files": ["https://example.com/report.pdf"]
}


For a local file, use `filePath` instead. The server uploads its contents using
multipart; the file must be on the machine running the MCP server, with an
absolute path and a size of at most 100 MB:```json
{
  "toPersonEmail": "colleague@example.com",
  "filePath": "/absolute/path/to/report.pdf"
}

On Windows, use an absolute Windows path such as C:\\Reports\\report.pdf.
Text and markdown are optional when attaching a file. files must be nonempty
and cannot be combined with filePath. Recipient fields (roomId, toPersonId,
toPersonEmail) and parentId for thread replies work as with text messages.
URL downloads and attachment limits are enforced by Webex; private URLs requiring
additional credentials cannot be used as public file URLs. See the
Webex attachment guide.

Files

Tool Description
webex_get_file_details Metadata (filename, type, size) for a message files[] URL
webex_download_file Read a file (max 10 MB): images inline, text paged with offset/maxChars, ZIP/JAR as an entry list
webex_get_message_images Download all image attachments on a message for LLM vision
webex_save_file Save one file to local disk (max 100 MB) and return its path
webex_save_message_files Save every file of a message to local disk

Reading received attachments

What webex_download_file returns depends on the file:

File Result
PNG, JPEG, GIF, WebP Inline ImageContent
Text: text/*, JSON, XML, SQL, diff/patch, source code JSON summary (totalChars, nextOffset, …) + the text, maxChars per call (default 50 000)
ZIP, JAR, WAR, EAR List of entries (name, size, encrypted); nothing is extracted
Anything else (PDF, docx, xlsx, …) Metadata and a hint to use webex_save_file

For PDF and Office documents, save the file and open it with the client's own tools
(many agents read PDFs and images directly; use a script for docx/xlsx). Saved files go to
//, where the download dir is WEBEX_DOWNLOAD_DIR
or ~/.cache/webex-mcp/downloads. Names are taken from Webex, decoded and made safe for
the file system; saving again replaces the file, and webex_save_message_files adds
(1) to same-named files of one message. The body streams to .part and is renamed
only when complete. Treat saved files as untrusted input: open or list them, never run them.

If Webex is still virus-scanning a file it answers 423 Locked; downloads wait for
Retry-After (up to 10 s) and retry three times before failing.

Memberships

Tool Description
webex_list_memberships List space memberships
webex_get_membership Get membership details
webex_add_membership Invite a person to a space
webex_update_membership Update membership (e.g. moderator)
webex_remove_membership Remove a person from a space

People

Tool Description
webex_get_people Search people by email, name, or ID
webex_get_person Get a person by ID (use me for yourself)

Teams

Tool Description
webex_list_teams List teams
webex_create_team Create a team
webex_get_team Get team details
webex_update_team Update a team
webex_delete_team Delete a team
webex_list_team_memberships List team memberships
webex_add_team_membership Add a person to a team
webex_get_team_membership Get team membership details
webex_update_team_membership Update team membership
webex_remove_team_membership Remove a person from a team

Webhooks

Tool Description
webex_list_webhooks List webhooks
webex_create_webhook Create a webhook
webex_get_webhook Get webhook details
webex_update_webhook Update a webhook
webex_delete_webhook Delete a webhook

Limitations

  • webex_search_messages works within a single space only (Webex REST API has no global search)
  • Search scans message history page by page — may be slow in large spaces
  • Bot must be a member of a space to read or post messages
  • OAuth uses user-delegated tokens; Bot mode uses a long-lived Bot token
  • Message files[] URLs require the access token; use webex_get_message_images / webex_download_file / webex_save_file instead of fetching the URL directly
  • Inline vision images are limited to PNG, JPEG, GIF, and WebP, max 10 MB each; inline text and archive listings are also limited to 10 MB
  • PDF and Office documents are not parsed by the server; save them and open them locally
  • ZIP64 archives cannot be listed inline; save them instead

Authentication modes

Mode Setup Best for
Bot token Copy token from developer portal Simple Cursor setup, bot identity
OAuth Integration webex-mcp login + client ID/secret User-delegated access with auto-refresh

Full guide

See docs/HOWTO.md for step-by-step setup: bot creation, scopes, Cursor config, example prompts, and troubleshooting.

Local development```bash

git clone https://github.com/yuryev89/webexmcp
cd webexmcp
npm install
cp .env.example .env
npm run dev -- --token "$WEBEX_ACCESS_TOKEN"
npm test
```

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Webex 怎么安装?

在客户端按下面的安装命令接入:# Run via npx (recommended) npx -y @yuryev89/webex-mcp@latest --token YOUR_ACCESS_TOKEN # Or install globally npm install -g @yuryev89/webex-mcp webex-mcp --token YOUR_ACCESS_TOKEN。装完在客户端配置里引用同一个包或端点。

Webex 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Webex 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Webex 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Webex 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Webex 能提供哪些能力?

资料显示能力标签包括 通讯。具体工具清单以官方文档为准。

Webex 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Webex 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-11-20。