WeCom Agent

WeCom Agent combines local access to a user's own WeCom data with a thin operation layer over the official WecomTeam CLI. Use the local track for historical chat search, exports, statistics, and file discovery. Use the online track for supported document and sheet operations.

Local reading

Search chats, inspect conversations, export media, and locate downloaded documents on the current device.

Online documents

Create and update supported WeCom documents through an authenticated WecomTeam CLI session.

Sheets

Create sheets, inspect structure, append rows, and update cell ranges.

Safety model

Keep reads local and require explicit confirmation for every online write.

Two operating tracks

Track	Default implementation	Best for
Local reading	`decrypt/`	Historical chats, contacts, conversations, full-text search, statistics, media export, and local file discovery
Online operations	`online/` plus `wecom-cli`	Documents, online sheets, smart sheets, and other APIs permitted by the current enterprise

The legacy self-built application under legacy/self-built-app/ is retained for reference, but it is not the primary path.

Current capability boundary

The repository wraps document, online sheet, and smart sheet operations. The exact online surface still depends on the installed wecom-cli version and the permissions granted by the user's enterprise.

With wecom-cli 0.1.9, online reads for normal document bodies, sheet cell data, and smart-sheet records are not exposed. Metadata, sheet lists, and field lists remain available. Locally cached or downloaded files can be read as a fallback, but they may not match the latest online revision.

Non-negotiable safety rule

Use the project only with data and accounts the operator is authorized to access. Every wrapped online write rejects execution until the caller passes confirmed=True after confirming the target, content, and impact.

Project layout

decrypt/                 Local decrypt, parse, search, and export tools
online/                  WecomTeam CLI wrappers
server.py                MCP facade for local and online tools
legacy/self-built-app/   Historical experiments
docs/                    Design notes and user documentation
tests/                   Unit tests

Continue with the quickstart for a minimal verified setup.