WeWork MCP Server
Manages configuration settings and API access tokens through environment variables stored in .env files for secure credential management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WeWork MCP Server analyze tasks for the marketing campaign project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: ClickUp MCP Integration
Prerequisites
Python 3.12+
WeWork API access token
uv package manager
Installation
Clone this repository:
git clone <repository-url>
cd wework-mcp-serverInstall dependencies:
uv syncConfiguration
Local Setup
1. WeWork Access Token
Option A: Environment Variable (Recommended)
Create a .env file in the project root:
WEWORK_ACCESS_TOKEN=your_actual_wework_token_hereOption 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
{
"mcpServers": {
"WeWork Task Analysis Server": {
"command": "uv",
"args": [
"--directory",
"/path/to/wework-mcp-server",
"run",
"wework_mcp_server.py"
]
}
}
}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ị)
# Install Railway CLI
npm install -g @railway/cli
# Deploy
chmod +x deploy_scripts.sh
./deploy_scripts.sh
# Choose option 1 (Railway)Deploy Options
Railway:
./deploy_scripts.sh→ option 1Docker:
docker-compose up --buildHeroku:
./deploy_scripts.sh→ option 4Manual: Xem
DEPLOY_GUIDE.md
Remote Claude Configuration
Sau khi deploy, cập nhật Claude config:
{
"mcpServers": {
"wework-remote": {
"command": "curl",
"args": ["-X", "GET", "https://your-app.railway.app/api/test"]
}
}
}📖 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
# Using uv
uv run wework_mcp_server.py
# Or with Python
python wework_mcp_server.py
# Run tests
python test_wework_server.pyData Structure
Task Analysis DataFrame Columns
Column | Description |
| Task category |
| Task name |
| Subtask (if any) |
| Assignee |
| Related people |
| Task description |
| Status (Completed/In Progress/Failed) |
| Achievement results |
| Failure reason |
| Start date |
| Due date |
| Completion date |
Troubleshooting
Common Issues
Access token expired: Update token in
.envfile orwework_mcp_server.pyDependencies not found: Run
uv syncto install all dependenciesClaude 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
python wework_mcp_server.py --debugSecurity Notes
⚠️ Important: For production use:
Always use environment variables (
.envfile) instead of hardcoding tokensAdd
.envto your.gitignoreto prevent committing sensitive dataDo 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
Available Tools
6 toolsanalyze_project_tasksC
Phân tích các tasks trong dự án
Args:
project_id: ID của dự án
export_csv: Có xuất file CSV không (default: False)
Returns:
Phân tích tasks dưới dạng dictionary
Inputs: project_id (required), export_csv.
find_project_by_nameB
Tìm dự án theo tên với độ tương đồng
Args:
project_name: Tên dự án cần tìm
threshold: Ngưỡng tương đồng tối thiểu (default: 0.3)
Returns:
Thông tin dự án phù hợp nhất
Inputs: project_name (required), threshold.
get_project_detailsB
Lấy chi tiết của một dự án
Args:
project_id: ID của dự án
Returns:
Chi tiết dự án bao gồm thông tin cơ bản
Inputs: project_id (required).
get_project_statisticsC
Lấy thống kê tổng quan về dự án
Args:
project_id: ID của dự án
Returns:
Thống kê chi tiết về dự án
Inputs: project_id (required).
search_projectsB
Tìm kiếm dự án theo tên
Args:
search_text: Text để tìm kiếm trong tên dự án
limit: Số lượng kết quả tối đa (default: 10)
Returns:
Danh sách các dự án phù hợp
Inputs: search_text (required), limit.
test_connectionB
Test kết nối với WeWork API
Returns:
Thông tin về trạng thái kết nối
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes: analyze_project_tasks focuses on task analysis, find_project_by_name and search_projects handle project discovery (though these two could be confused), get_project_details and get_project_statistics provide different project information, and test_connection is clearly separate. The main ambiguity is between find_project_by_name and search_projects, which both search projects by name with slightly different approaches.
Tool names follow a consistent snake_case pattern with clear verb_noun structure (analyze_project_tasks, find_project_by_name, get_project_details, etc.). The only minor deviation is test_connection, which uses a simpler verb_noun pattern but still fits the overall naming convention.
With 6 tools, this is well-scoped for a project management server focused on WeWork. The count is appropriate as it covers core operations (project discovery, details, statistics, task analysis) without being overwhelming or too sparse for the domain.
The toolset covers project discovery and analysis well but has notable gaps in project lifecycle management. There are no tools for creating, updating, or deleting projects or tasks, which limits agents to read-only operations. However, for analysis and monitoring purposes, the existing tools provide reasonable coverage.
Maintenance
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Model Context Protocol server for todo.vu task management and time tracking.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Related MCP Servers
AlicenseNot gradedqualityNot gradedmaintenanceA Model Context Protocol server that enables Claude Desktop users to interact directly with PostHog, allowing them to view projects and create annotations through natural language commands.10MIT- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables Large Language Models to interact with ClickUp workspace tasks and data, allowing creation and retrieval of tasks through natural language.196MIT
- AlicenseBqualityFmaintenanceA Model Context Protocol server that enables AI assistants to interact with Feishu project management systems, allowing retrieval of project views and work items.612MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.38MIT