Manages configuration settings and API access tokens through environment variables stored in .env files for secure credential management.
WeWork MCP Server
A Model Context Protocol (MCP) server that provides access to WeWork project management data through Claude and other LLM clients. This server exposes WeWork project information, task analysis, and project management tools.
Features
🔍 Project Search
- Search projects by name with fuzzy matching
- Find best matching projects using cosine similarity
- Get list of all available projects
📊 Project Analysis
- Detailed task analysis within projects
- Completion progress statistics
- Task categorization by status and assignee
- Export data to CSV files
📋 Information Management
- Get detailed project information
- Track deadlines and completion dates
- Analyze task failure reasons
Prerequisites
- Python 3.12+
- WeWork API access token
- uv package manager
Installation
- Clone this repository:
- Install dependencies:
Configuration
Local Setup
1. WeWork Access Token
Option A: Environment Variable (Recommended)
Create a .env
file in the project root:
Option B: Direct Configuration
Update the WEWORK_ACCESS_TOKEN
in wework_mcp_server.py
with your actual WeWork API token.
2. Claude Desktop Configuration (Local)
Add this server to your Claude Desktop configuration file:
Windows: %APPDATA%/Claude/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
3. Restart Claude Desktop
After adding the configuration, restart Claude Desktop to apply changes.
Remote Deployment 🚀
Deploy the server to cloud platforms for remote access by Claude.
Quick Deploy với Railway (Khuyến nghị)
Deploy Options
- Railway:
./deploy_scripts.sh
→ option 1 - Docker:
docker-compose up --build
- Heroku:
./deploy_scripts.sh
→ option 4 - Manual: Xem
DEPLOY_GUIDE.md
Remote Claude Configuration
Sau khi deploy, cập nhật Claude config:
📖 Chi tiết: Xem DEPLOY_GUIDE.md
cho hướng dẫn deploy đầy đủ.
Usage
Example Prompts
- "Show me all available projects"
- "Find project 'marketing campaign'"
- "Analyze tasks for project ID 12345"
- "Get statistics for the development project"
- "Export task analysis to CSV"
Available Resources
file://projects/available
- List all available WeWork projects
Available Tools
MCP Tools (Local)
search_projects
- Search for projects by namefind_project_by_name
- Find project with similarity matchingget_project_details
- Get detailed information about a specific projectanalyze_project_tasks
- Analyze tasks within a projectget_project_statistics
- Get comprehensive project statistics
HTTP Endpoints (Remote)
GET /health
- Health checkGET /api/test
- Test WeWork connectionGET /api/projects?search=<text>
- Search projectsPOST /api/project/details
- Get project detailsPOST /api/project/analyze
- Analyze project tasks
Development
Run Server for Testing
Data Structure
Task Analysis DataFrame Columns
Column | Description |
---|---|
Loại công việc | Task category |
Tên công việc | Task name |
Công việc con | Subtask (if any) |
Người thực hiện | Assignee |
Người liên quan | Related people |
Mô tả công việc | Task description |
Trạng thái | Status (Completed/In Progress/Failed) |
Kết quả đạt được | Achievement results |
Lí do thất bại | Failure reason |
Ngày bắt đầu | Start date |
Deadline | Due date |
Ngày hoàn thành | Completion date |
Troubleshooting
Common Issues
- Access token expired: Update token in
.env
file orwework_mcp_server.py
- Dependencies not found: Run
uv sync
to install all dependencies - Claude Desktop doesn't recognize server: Check file paths in config and restart Claude Desktop
- CSV encoding issues: Files are exported with UTF-8-BOM encoding
Debug Mode
Security Notes
⚠️ Important: For production use:
- Always use environment variables (
.env
file) instead of hardcoding tokens - Add
.env
to your.gitignore
to prevent committing sensitive data - Do not commit access tokens to git repository
- Use only in trusted environments
- Regularly rotate your access tokens
License
This project is licensed under the MIT License.
Acknowledgments
- WeWork for providing the project management platform and API
- Model Context Protocol team for the MCP framework
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server providing access to WeWork project management data, enabling project search, task analysis, and statistics retrieval through Claude and other LLM clients.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.Last updated -215JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that allows LLMs to interact with web content through standardized tools, currently supporting web scraping functionality.Last updated -PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.Last updated -JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude Desktop to access structured employee data and perform HR operations including employee lookups, searches, and global leave requests.Last updated -JavaScriptMIT License