Skip to main content
Glama
WeWork MCP Server

WeWork MCP Server

by FOX2920

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

  1. Clone this repository:

git clone <repository-url>
cd wework-mcp-server
  1. Install dependencies:

uv sync

Configuration

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_here

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

{
  "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 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:

{
  "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 name

  • find_project_by_name - Find project with similarity matching

  • get_project_details - Get detailed information about a specific project

  • analyze_project_tasks - Analyze tasks within a project

  • get_project_statistics - Get comprehensive project statistics

HTTP Endpoints (Remote)

  • GET /health - Health check

  • GET /api/test - Test WeWork connection

  • GET /api/projects?search=<text> - Search projects

  • POST /api/project/details - Get project details

  • POST /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.py

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

  1. Access token expired: Update token in .env file or wework_mcp_server.py

  2. Dependencies not found: Run uv sync to install all dependencies

  3. Claude Desktop doesn't recognize server: Check file paths in config and restart Claude Desktop

  4. CSV encoding issues: Files are exported with UTF-8-BOM encoding

Debug Mode

python wework_mcp_server.py --debug

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

Available Tools

6 tools
analyze_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

    B3.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers