# WeCom MCP

> WeCom / 企业微信 connects your AI client directly to China's top enterprise communication platform. Your agent handles complex internal operations, letting you list departments, find user profiles, check team attendance, and send messages—all through natural conversation instead of the admin backend.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** enterprise-messaging, team-collaboration, attendance-tracking, employee-management, internal-comms, api-integration

## Description

Managing a large organization usually means clicking through confusing dashboards just to get basic employee data or check who was supposed to clock in. This MCP lets your agent bypass all that complexity. It treats WeCom like an extension of your chat interface, letting you talk to it about your company's structure and workforce. Need to know which users belong to the 'Finance' group? Ask. Want to see who clocked in this morning? Ask. Your agent pulls data on departments, retrieves detailed employee records, checks attendance logs, or sends a quick heads-up message—all instantly. Because Vinkius hosts this MCP, you connect your preferred AI client once and gain access to all these core business functions, turning rigid enterprise tools into simple conversational commands.

## Tools

### get_app_details
Pulls detailed information about an application agent within WeCom.

### get_attendance_data
Retrieves current and past employee check-in or attendance records for specified staff members.

### get_department
Fetches specific details about a named department in the organization.

### get_tag_users
Lists all users who have been assigned one or more organizational tags.

### get_user
Gets comprehensive profile details for a single employee using their identifier.

### list_departments
Provides an exhaustive list of all departments currently set up in the organization.

### list_menu
Retrieves the custom menu configurations for a specific internal application agent.

### list_tags
Provides a complete list of all functional or organizational tags used by the company.

### list_users
Lists all employee users who belong to a specific department or unit.

### send_message
Sends a plain text message directly to any specified user within the platform.

## Prompt Examples

**Prompt:** 
```
List all departments in our organization.
```

**Response:** 
```
I've retrieved the organizational structure for WeCom. You have 5 primary departments, including 'Engineering', 'Marketing', and 'Sales'. Which one would you like to see the users for?
```

**Prompt:** 
```
Send a message to user 'Mario' saying 'The deployment is complete'.
```

**Response:** 
```
Done! I've sent your message to Mario through the WeCom application. He has been notified that the deployment is complete.
```

**Prompt:** 
```
Show me the attendance data for 'mario,renato' from today.
```

**Response:** 
```
I've retrieved the check-in data for the specified users. Mario punched in at 9:00 AM, and Renato punched in at 8:45 AM. Both are currently marked as active in the system.
```

## Capabilities

### Audit Team Attendance
Your agent retrieves real-time check-in data for staff, letting you audit workforce activity without logging into the attendance portal.

### Map Organizational Structure
You can ask the MCP to list all departments and then narrow down the employee roster within any specific unit.

### Identify Specific Users
The agent finds people based on their details, department, or assigned organizational tags.

### Send Targeted Messages
You send instant text messages to any specified user directly through the chat interface.

## Use Cases

### The HR Audit
A manager needs to confirm which staff members are in the new 'Product Development' department and whether they all clocked in today. The agent first uses `list_departments` to verify the unit, then uses `list_users` for the roster, and finally calls `get_attendance_data` to generate a single compliance report.

### The Quick Announcement
A team lead needs to notify five specific people that a policy has changed. Instead of copying their names and sending messages one by one, the agent uses `get_tag_users` to find all users with the 'Leadership' tag, then calls `send_message` once to reach everyone.

### The IT Deep Dive
An admin needs to know what a specific internal app can do. They use `list_menu` and `get_app_details`, getting the exact configuration metadata without needing access to the backend system settings.

### The Missing Employee Profile
A user needs Jane Doe's phone number and manager name. Instead of searching through multiple HR systems, they ask their agent, which immediately uses `get_user` to pull all the necessary details in one conversational reply.

## Benefits

- Check attendance instantly. Instead of logging into a separate dashboard to see who clocked in, your agent uses `get_attendance_data` to give you real-time check-in summaries.
- Map out staff relationships. Use `list_departments` and then `list_users` to build an accurate organizational chart without manual data exports or spreadsheet manipulation.
- Communicate targeted updates. Send a message using `send_message` directly through your agent, ensuring the announcement hits the right person immediately, regardless of their location in the org structure.
- Segment users precisely. Need all compliance officers? Use `list_tags` first to see available groups, then use `get_tag_users` to pull only those employees who match that tag.
- Avoid UI overload. Your agent handles complex lookups like getting user details (`get_user`) or department info (`get_department`), so you never have to navigate the WeCom Admin Backend yourself.

## How It Works

The bottom line is that instead of navigating complex admin backends, you just talk to it about company operations.

1. Subscribe to this MCP and enter your WeCom Corp ID, App Secret, and Agent ID.
2. Connect the MCP to your AI client (Claude, Cursor, etc.).
3. Tell your agent what you need: 'What are the users in the Engineering department?' The agent processes the request and provides the data.

## Frequently Asked Questions

**How do I list all departments using WeCom / 企业微信 MCP?**
You ask your agent to list all departments. The tool uses `list_departments` and returns a full roster of every department name currently in your organization.

**Can the WeCom / 企业微信 MCP check if an employee was present today?**
Yes, you can retrieve attendance records using `get_attendance_data`. Just tell your agent which user or group you want to audit, and it pulls the check-in details.

**What is the difference between listing users and getting a user profile?**
Listing users (`list_users`) gives you a roster of people in one place. Getting a user profile (`get_user`) provides deep, specific details about just that single person.

**Does the WeCom / 企业微信 MCP handle group messaging?**
You can send messages using `send_message` to individual users or groups found via tools like `get_tag_users`, making communication centralized and traceable.

**Can I get details about an internal application? (WeCom / 企业微信 MCP)**
Yes. You can use `list_menu` to see the app's custom menu structure, or `get_app_details` for deeper metadata on its functionality.