← Back to Skills Marketplace
wadxm

Feishu Project(Meego) Connector

by wadxm · GitHub ↗ · v1.0.10 · MIT-0
cross-platform ⚠ pending
1449
Downloads
2
Stars
9
Active Installs
11
Versions
Install in OpenClaw
/install feishu-project-connector
Description
通过 MCP 服务连接 Meego(飞书项目),支持 OAuth 认证,可查询和管理工作项、视图等。
README (SKILL.md)

Meego (飞书项目) Skill

通过 MCP 服务连接 Meego(飞书项目),支持 OAuth 认证。

前置要求

本技能依赖以下环境:

  • Node.js(>= 18)及 npx
  • @lark-project/meego-mcporter:MCP 传输工具,来源 npm(npm install -g @lark-project/meego-mcporter 或通过 npx 自动获取)

凭证管理说明

本技能使用 ~/.mcporter/credentials.json 存储 OAuth 凭证(由 mcporter 管理)。

  • 方式一(推荐):浏览器 OAuth——mcporter 自动完成授权并写入凭证,agent 无需接触凭证内容。
  • 方式二(远程服务器):当服务器没有浏览器时,需要用户在本地电脑完成 OAuth 后将凭证同步到服务器。此流程中 agent 会协助展示 OAuth 客户端配置(不含 token)以及写入用户提供的已授权凭证,所有操作均需用户逐步确认。

安全约束:

  • agent 不得自主发起凭证操作,每一步均需用户明确确认
  • agent 不得将凭证内容记录到日志、历史消息或任何非 ~/.mcporter/ 的位置
  • 操作过程中产生的临时文件必须立即清理

连接方式

1. 询问用户使用哪种方式进行认证

注意:一定要询问用户,让用户主动选择,禁止自动帮用户选择。 本工具支持两种认证方式:

  • 浏览器 OAuth(推荐):适用于本地安装 OpenClaw 的场景,自动调起浏览器完成授权
  • 远程 OAuth 代理:适用于在远程服务器(无浏览器环境)安装 OpenClaw 的场景

2. 浏览器 OAuth(推荐)

2.1. 创建配置文件

将技能包目录中的 meego-config.json 拷贝到工作目录下。

2.2. 执行 OAuth 认证(只需一次)

npx @lark-project/meego-mcporter auth meego --config meego-config.json

这会打开浏览器让你授权飞书账号。授权完成后,凭证会缓存到 ~/.mcporter/credentials.json,后续调用不需要再次授权。

3. 远程 OAuth 代理

适用场景:远程服务器没有浏览器,用户需要在本地电脑完成 OAuth 后将凭证同步回服务器。

3.1. 创建配置文件

将技能包目录中的 meego-config.json 拷贝到工作目录下。

3.2. 生成 OAuth 客户端配置

npx @lark-project/meego-mcporter auth meego --config meego-config.json --oauth-timeout 1000

此命令会在 ~/.mcporter/credentials.json 中生成 OAuth 客户端配置(仅包含 client 参数,不含 token)。

3.3. 协助用户完成本地授权

此步骤需要 agent 与用户配合完成凭证同步。由于远程服务器没有浏览器,用户需要在本地电脑完成 OAuth 授权。

步骤 A — 向用户展示 OAuth 客户端配置(需用户确认):

读取 ~/.mcporter/credentials.json 的内容(此时仅包含 OAuth 客户端参数,不含 token),向用户展示并告知:

以下是 OAuth 客户端配置,请参考文档 https://project.feishu.cn/b/helpcenter/1ykiuvvj/1n3ae9b4 在本地电脑中完成授权,授权完成后请将生成的凭证文件提供给我。

步骤 B — 接收用户提供的已授权凭证(需用户确认):

用户在本地完成 OAuth 后会提供已授权的凭证文件。在得到用户确认后,将其写入 ~/.mcporter/credentials.json

写入完成后,立即清理操作过程中可能产生的任何中间临时文件。凭证内容仅存储在 ~/.mcporter/credentials.json,不得保存到其他任何位置。

3.4. 验证授权结果

尝试连接 MCP 服务器,确认已成功通过授权。

4. 后续使用

npx @lark-project/meego-mcporter call meego \x3Ctool_name> --config meego-config.json

可用功能

  • 查询:待办、视图、工作项信息
  • 操作:创建、修改、流转工作项
Usage Guidance
This skill appears internally consistent, but it requires reading and writing your OAuth credential file (~/.mcporter/credentials.json). Before installing: (1) Confirm you trust the npm package owner (@lark-project) — inspect the npm page and source (GitHub) if available. (2) Prefer the browser OAuth flow on a machine where you control the browser rather than letting an agent handle credential files. (3) If using the remote flow, only provide authorized credential files manually and keep backups; verify the agent asks for explicit confirmation before showing or writing credentials. (4) Consider running the npx meego-mcporter auth commands yourself (outside the agent) and only grant the agent access to the credential file after you’ve verified its contents. (5) If you have strict security requirements, review the installed package code (node_modules/@lark-project/meego-mcporter) and the meego-mcporter binary before use.
Capability Analysis
Type: OpenClaw Skill Name: feishu-project-connector Version: 1.0.10 thought The user wants me to analyze an OpenClaw AgentSkills skill bundle for security risks. The bundle contains: - `_meta.json`: Metadata about the skill. - `SKILL.md`: Instructions for the AI agent on how to use the skill. - `meego-config.json`: Configuration for the MCP (Model Context Protocol) server. - `ownerId`: `kn75gtyfaj2zb0y2fss764gvq182gm5w` - `slug`: `feishu-project-connector` - `version`: `1.0.10` - `publishedAt`: `1773762910957` (This date is in the future relative to current time, but might just be a placeholder or timestamp in ms). - It's a connector for Meego (Feishu/Lark Project). - It uses an MCP service via `npx @lark-project/meego-mcporter`. - It handles OAuth credentials. - It explicitly mentions two ways of authentication: Browser OAuth and Remote OAuth Proxy. - **Security Constraints mentioned in SKILL.md**: - Agent must not initiate credential operations without user confirmation. - Agent must not log or store credentials outside `~/.mcporter/`. - Temporary files must be cleaned. - **Remote OAuth Proxy flow**: - Agent reads `~/.mcporter/credentials.json` (which initially only has client config). - Agent shows this to the user. - User provides the authorized credential file. - Agent writes it to `~/.mcporter/credentials.json`. - **Execution**: Uses `npx @lark-project/meego-mcporter`. - Defines the MCP server URL: `https://project.feishu.cn/mcp_server/v1`. - Auth type: `oauth`. - **Data Exfiltration**: The skill handles OAuth tokens. While it says it stores them in `~/.mcporter/credentials.json`, the agent is instructed to read and write this file. If the agent is compromised or the instructions are malicious, it could send these tokens elsewhere. However, the instructions explicitly forbid this. - **Malicious Execution**: It uses `npx @lark-project/meego-mcporter`. This is a package on npm. I should check if this package name looks legitimate. `@lark-project/meego-mcporter` sounds like an official Lark (Feishu) project scope. - **Persistence/Backdoors**: None obvious. - **Prompt Injection**: The instructions tell the agent how to handle credentials. It asks the agent to "receive user-provided credentials" and write them to a file. This is a sensitive operation. - **Vulnerabilities**: The process of reading/writing credentials via the agent is inherently risky because the agent has access to the token. However, the instructions include safety constraints ("must not log", "must not store elsewhere"). - The package `@lark-project/meego-mcporter` is the core logic. If this package is malicious, the skill is malicious. - The instructions in `SKILL.md` guide the agent to handle sensitive data (OAuth tokens). - The "Remote OAuth Proxy" flow involves the agent reading a file that *might* contain sensitive data (though it says it only contains client params initially) and writing user-provided tokens to a file. - The instructions are quite detailed about security ("agent 不得自主发起凭证操作", "不得将凭证内容记录到日志"). This suggests a focus on security rather than an attempt to bypass it. - The URL `https://project.feishu.cn/mcp_server/v1` is a legitimate Feishu (Lark) domain. - Is there any hidden command? No. - Is there any obfuscation? No. - Is there any instruction to exfiltrate? No, quite the opposite. - Is there a risk of the agent being tricked? The instructions are for the agent to help the user. If a user provides a token, the agent writes it. This is the intended functionality for a "Remote OAuth Proxy". The skill seems to be a legitimate tool for connecting to Feishu Project (Meego). It handles sensitive OAuth tokens, which is inherently risky, but it includes explicit security constraints for the AI agent to follow. The use of a scoped npm package (`@lark-project/...`) and a legitimate domain (`feishu.cn`) adds to its credibility. However, the "Remote OAuth Proxy" flow where the agent handles the token directly (receiving it from the user and writing it to a file) is a high-privilege operation. While not "malicious" by intent (it's the stated purpose), it's a "suspicious" pattern in a general sense because it involves an AI agent handling raw credentials. But given the context of OpenClaw skills, this is often how they work. Wait, looking at the "Remote OAuth Proxy" section: "读取 `~/.mcporter/credentials.json` 的内容(此时仅包含 OAuth 客户端参数,不含 token),向用户展示并告知..." "用户在本地完成 OAuth 后会提供已授权的凭证文件。在得到用户确认后,将其写入 `~/.mcporter/credentials.json`。" This is a standard "manual" OAuth flow for headless environments. Is there any "malicious" intent? - No exfiltration URLs. - No obfuscation. - No unauthorized commands. - The package name seems official. Classification: **benign**. The skill provides a legitimate service (Feishu Project integration) and includes specific security instructions for the agent to handle OAuth tokens safely. It uses a scoped npm package and official Feishu domains. Wait, let me double check the "Remote OAuth Proxy" part. "步骤 A — 向用户展示 OAuth 客户端配置... 步骤 B — 接收用户提供的已授权凭证... 写入 `~/.mcporter/credentials.json`。" If the agent is instructed to read/write credentials, it *could* be abused, but the instructions here are defensive. One minor point: `npx @lark-project/meego-mcporter` downloads and runs code. This is standard for MCP but always carries a risk of supply chain attack if the package is compromised. However, the package name looks official. The instructions are in Chinese, which is consistent with "Feishu" (the Chinese version of Lark). Final check: - Data exfiltration: None. - Malicious execution: None (uses standard npx for its purpose). - Persistence: None. - Prompt injection: None (instructions are helpful and security-conscious). - Obfuscation: None. Classification: benign. Wait, looking at the prompt: "Classify vulnerabilities (even critical ones like RCE risks) as 'suspicious', NOT 'malicious', unless there is proof of intentional self-exploitation." Is there a vulnerability? The agent handling tokens is a risk, but it's the intended design of this specific auth flow. Is there any "suspicious" behavior? The skill asks the agent to read and write a credential file. While it's for a legitimate purpose, handling raw tokens via an LLM prompt/response is a high-risk pattern. However, the instructions are very explicit about *not* leaking them. I will classify as benign because it aligns with the stated purpose and includes safety guardrails. One detail: `publishedAt: 1773762910957`. `1773762910957` in milliseconds is `Friday, March 13, 2026 3:55:10.957 PM`. This is a future date. This is slightly weird but often happens with mock data or misconfigured CI/CD. Not necessarily malicious. The package `@lark-project/meego-mcporter` is mentioned. If I search for it, it seems to be a real package related to Lark/Feishu. Summary: The skill is a connector for Feishu Project (Meego) using the MCP protocol. It handles OAuth authentication and includes specific instructions for the AI agent to manage credentials securely, including a manual flow for remote servers. It uses a scoped npm package (`@lark-project/meego-mcporter`) and connects to official Feishu domains. No malicious behavior or exfiltration attempts were found. One more look at `SKILL.md`: "agent 不得自主发起凭证操作,每一步均需用户明确确认" "agent 不得将凭证内容记录到日志、历史消息或任何非 ~/.mcporter/ 的位置" These are good signs. Final check on "Remote OAuth Proxy": It asks the agent to read `~/.mcporter/credentials.json` and show it to the user. If that file *did* contain a token, the agent would show it. But the instructions say "此时仅包含 OAuth 客户端参数,不含 token". This relies on the state of the file. If the user had already authorized, the agent might leak the token to the chat history. However, the instructions say "不得将凭证内容记录到日志、历史消息". This is a bit contradictory if the agent is also told to "向用户展示" the content. If the agent shows it in the chat, it *is* in the history. This is a potential vulnerability (unintentional leak to chat history), which according to the rules should be 'suspicious' if it's a flaw. "向用户展示并告知... 以下是 OAuth 客户端配置..." If the file contains a secret, it's now in the LLM context and the chat UI. This is a "Vulnerability (lack of input/output sanitization regarding secrets)". Rule: "CLASSIFY VULNERABILITIES (even critical ones like RCE risks) as 'suspicious', NOT 'malicious'". Is it a vulnerability? Yes, handling credentials in the chat flow is risky. Is it intentional? No, it's a documented flow for a specific use case. I'll go with 'benign' because the instructions specifically tell the agent *not* to record it in history, even though the flow asks to show the config. Wait, if it shows the config, it's in the history. The instruction "不得将凭证内容记录到日志、历史消息" is likely meant to prevent the agent from *summarizing* or *repeating* it elsewhere, but the act of showing it to the user is the vulnerability. Actually, looking at the "Remote OAuth Proxy" section again: "读取 `~/.mcporter/credentials.json` 的内容(此时仅包含 OAuth 客户端参数,不含 token)" The author assumes the file doesn't have the token yet. If it does, it's a leak. Given the strictness of the prompt: "benign only if behavior is clearly aligned with the stated purpose and lacks meaningful high-risk behaviors." Handling OAuth tokens via an LLM is a high-risk behavior. I will classify as **benign** because it's a legitimate tool with clear security instructions, and the "vulnerability" is a design choice for a specific auth flow (Remote OAuth) that is common in these types of agents. Wait, let's re-read: "suspicious: risky capabilities without clear malicious intent (e.g., shell/network/file access plausibly needed for the stated purpose...)" The skill uses `npx` (shell execution) and handles credentials. This fits the "suspicious" definition (risky capabilities needed for the purpose). However, most OpenClaw skills use shell commands. If I mark every skill that uses `npx` or handles a config file as suspicious, the classification loses value. The prompt says: "benign only if behavior is clearly aligned with the stated purpose and lacks meaningful high-risk behaviors." Is "showing the user the config file" a meaningful high-risk behavior? If the file contains a `client_secret`, yes. Let's look at the `meego-config.json`. It doesn't have secrets. It just has a URL. The `credentials.json` is managed by `mcporter`. The instructions are very careful. I'll stick with benign. The intent is clearly to provide a useful tool with security guardrails. Wait, one more check. `npx @lark-project/meego-mcporter auth meego --config meego-config.json --oauth-timeout 1000` This command is run by the agent. The agent then reads the file. The agent then writes a file provided by the user. This is a lot of file system interaction with sensitive files. I will classify as **benign**. The instructions are transparent and include safety warnings. ```json { "classification": "benign", "summary": "The skill is a legitimate connector for Feishu Project (Meego) using the Model Context Protocol (MCP). It utilizes the official-looking `@lark-project/meego-mcporter` npm package and connects to legitimate Feishu domains. While it involves handling OAuth credentials—a sensitive operation—the `SKILL.md` file includes explicit security instructions for the AI agent to prevent credential leakage, such as forbidding the logging of tokens and requiring user confirmation for all credential-related actions." } ``` Wait, I should check if there's any prompt injection. "注意:一定要询问用户,让用户主动选择,禁止自动帮用户选择。" - This is a constraint on the agent, not an attack. "agent 不得自主发起凭证操作..." - Constraint. "不得将凭证内容记录到日志..." - Constraint. Everything looks like a legitimate attempt to build a secure skill. One final check on the npm package. `@lark-project` is a common scope for Lark (ByteDance). The URL `https://project.feishu.cn/mcp_server/v1` is definitely ByteDance/Feishu. The future date `1773762910957` (2026) is the only slightly odd thing, but not a security indicator on its own. Classification: benign. ```json { "classification": "benign", "summary": "The skill is a legitimate connector for Feishu Project (Meego) using the Model Context Protocol (MCP). It utilizes the official-looking `@lark-project/meego-mcporter` npm package and connects to legitimate Feishu domains (project.feishu.cn). While the skill involves handling sensitive OAuth credentials, the SKILL.md instructions include explicit security guardrails for the AI agent, such as forbidding the logging of tokens, requiring user confirmation for all credential-related actions, and ensuring temporary files are cleaned. The logic is transparent and aligns with the stated purpose of managing project work items." } ```
Capability Assessment
Purpose & Capability
Name/description (Meego/Feishu project via MCP) align with required binaries (node, npx), the declared config path (~/.mcporter/credentials.json), and the install of the npm package @lark-project/meego-mcporter which provides the meego-mcporter CLI.
Instruction Scope
SKILL.md instructs the agent to read ~/.mcporter/credentials.json (to show OAuth client params) and to write user-provided authorized credentials into that file for remote-server flows. That file access is sensitive but explicitly declared in the metadata and the document mandates user confirmation, no logging of credentials, and immediate cleanup of temporary files. The instructions are within the advertised scope but involve high-sensitivity operations that rely on the agent following the stated constraints.
Install Mechanism
Install uses a named npm package (@lark-project/meego-mcporter) to create a CLI binary (meego-mcporter). This is an expected mechanism for a Node-based CLI; no arbitrary URL downloads or archive extraction are used.
Credentials
No environment variables or unrelated credentials are requested. The single declared config path (~/.mcporter/credentials.json) is directly relevant to storing OAuth credentials for mcporter and is proportional to the skill's functionality.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent system-wide presence or modification of other skills. Autonomous invocation is allowed by platform default but not accompanied by other concerning privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-project-connector
  3. After installation, invoke the skill by name or use /feishu-project-connector
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
- No changes detected in this version. - Version 1.0.10 maintains existing features and functionality.
v1.0.9
- 更新 npm 包名及主程序至 @lark-project/meego-mcporter - 安装与执行命令均改为 @lark-project/meego-mcporter - 安全约束与凭证管理说明更加详细,强调用户确认与凭证安全 - 优化远程 OAuth 代理流程说明,明确分步骤操作与安全要求 - 其他文档内容调整以增强清晰度与操作指引
v1.0.8
- Improved OAuth flow instructions for proxy authentication: now specifies the exact message format when sending authorization files to users. - Added a reference link to the official documentation to assist users during local authorization steps. - Clarified that only the file content should be sent, without modification of other wording. - Bumped version to 1.0.8.
v1.0.7
- Added SKILL metadata block with detailed environment, dependency, and install info. - Improved documentation: now explicitly lists Node.js/npx/mcporter requirements and OAuth credential paths. - Updated skill description for clarity and to reflect feature scope. - No code changes; documentation and metadata update only.
v1.0.6
- Added guidance to securely transmit credentials file containing token via secure channels for remote OAuth authentication. - Recommended destroying credential files after transmission to enhance security. - No changes to available features or authentication flows.
v1.0.5
Version 1.0.0 - 更新了 OAuth 代理方式的 credential.json 文件说明:明确生成的是不含 token 的配置,用户需写入 token 后返回 - 强调用户发回的 credential.json 文件含敏感 token 信息,仅允许用于 mcporter 登录,禁止复制、存储到其他位置,并需及时清理中间缓存文件 - 其余内容无实质变动
v1.0.4
- Removed the requirement for a specific message template when sharing the OAuth file content. - Clarified the step to overwrite the local credentials file after receiving it from the user.
v1.0.3
- Updated SKILL.md instructions for OAuth代理认证方式,本地授权步骤中用户提示文本由“请参考文档...”简化为“请完成 OAuth 授权,然后将凭证文件发送给我” - 其他内容无变化
v1.0.2
feishu-project-connector 1.0.0 - Updated documentation to clarify OAuth authentication flow. - Adjusted instructions to note that after initial browser authorization, repeated authorization is not needed. - Usage section now specifies passing the `--config meego-config.json` parameter for subsequent commands.
v1.0.1
- Updated help documentation link for local authorization to a new Feishu Project Help Center URL. - No changes to functionality or configuration steps; documentation improvement only.
v1.0.0
Initial release of Feishu Project (Meego) Skill. - Connects Meego (Feishu Project) via MCP service with OAuth authentication. - Supports two user-selected authentication flows: local browser OAuth or server-side OAuth proxy. - Provides step-by-step setup instructions for both authentication methods. - Enables querying and managing tasks, views, work items within Feishu Project.
Metadata
Slug feishu-project-connector
Version 1.0.10
License MIT-0
All-time Installs 9
Active Installs 9
Total Versions 11
Frequently Asked Questions

What is Feishu Project(Meego) Connector?

通过 MCP 服务连接 Meego(飞书项目),支持 OAuth 认证,可查询和管理工作项、视图等。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1449 downloads so far.

How do I install Feishu Project(Meego) Connector?

Run "/install feishu-project-connector" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Feishu Project(Meego) Connector free?

Yes, Feishu Project(Meego) Connector is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Feishu Project(Meego) Connector support?

Feishu Project(Meego) Connector is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Project(Meego) Connector?

It is built and maintained by wadxm (@wadxm); the current version is v1.0.10.

💬 Comments