Weekly Reports

by kaneyxx

Not rated
GitHub

About

Lightweight server for processing weekly reports via Google Sheets, providing development mode and automated validation for team tracking workflows.

Details

Author
kaneyxx
Repository
kaneyxx/weekly-report-mcp
Categories
Productivity, Design, Workplace, Developer Tools, Communication, Automation, Infrastructure

- Check who hasn't submitted their weekly reports
- Get detailed information about a specific person's report status
- View submission statistics
- Get a list of all team members who should submit reports

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Weekly Reports
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

```bash

pip install -e .

./install_server.sh

check_missing_reports

Check who hasn't submitted their weekly reports.

check_person_report

Get detailed information about a specific person's report status.

get_submission_stats

Get submission statistics.

- check_missing_reports - Check missing reports
- check_person_report - Check a specific person's report
- get_submission_stats - Get submission statistics
```29:["$","div",

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "weekly reports": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Weekly Report Checker MCP Server

An MCP (Model Context Protocol) server that checks weekly report submissions in a Google Sheet.

Features

- Check who hasn't submitted their weekly reports
- Get detailed information about a specific person's report status
- View submission statistics
- Get a list of all team members who should submit reports

Prerequisites

- Python 3.10 or higher
- A Google Sheets service account JSON file (service_account.json)
- Access to the "週報" Google Sheet

Installation

# Install the package
pip install -e .

Install in Claude Desktop

./install_server.sh

or

mcp install mcp_server.main --name "週報檢查器"

Usage

# Run in development mode
./run_server.sh

or

mcp dev mcp_server.main

Run directly

python -m mcp_server.main

or

weekly-report-server

Example Client

Run the example client:

python example_usage.py

API Reference

Resources

- weekly-report://status - Get who hasn't submitted reports
- weekly-report://stats - Get submission statistics
- weekly-report://all-members - Get all team members
- weekly-report://person/{name} - Get a specific person's status

Tools

- check_missing_reports - Check missing reports
- check_person_report - Check a specific person's report
- get_submission_stats - Get submission statistics
```29:["$","div",

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.