Summary

You run a self-contained MCP server that creates daily and weekly productivity summaries by analyzing your Slack messages, Calendar events, and Gmail activity. This server processes data locally to deliver actionable insights, automate report generation, and store past summaries for quick reference.

How to use

You interact with Summary MCP through an MCP client to generate, view, and compare productivity summaries. You can generate a daily summary for today or a specific date, produce a full weekly summary, fetch quick stats without a full report, and retrieve or compare past periods. Use the built-in tools to list saved summaries, retrieve a particular summary, or compare two time ranges to see how your productivity trends evolve.

Key workflows you can perform regularly include: creating end-of-day summaries with optional HTML or Markdown output, generating a comprehensive weekly report, and quickly checking metrics like messages read, meetings held, or emails processed. You may also compare two weeks to see whether your focus improved over time.

To start a session with the MCP client, ensure the MCP server is configured and running, then issue commands through the MCP client interface to generate and fetch the outputs in your preferred format.

How to install

Prerequisites you need before installation are Node.js and npm. Verify Node.js is installed with node --version and npm with npm --version.

Step 1: Clone the project directory and install dependencies.

cd ~/shopify-projects
git clone <repo-url> summary-mcp
cd summary-mcp
npm install

Step 2: Configure the MCP client to connect to this server. Create or update your MCP configuration to include a stdio connection that runs the server entry point. Use the following example to reference the exact command path for your environment.

{
  "mcpServers": {
    "summary_mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/your-user/path/to/summary-mcp/src/index.js"],
      "env": {}
    }
  }
}

Additional sections

Configuration and automation details are provided to help you tailor how summaries are generated and managed. You can enable or disable debug logging, customize automatic generation schedules, and specify where summaries are stored.

Automation for generating summaries runs on a schedule and can be installed or removed with dedicated scripts. You can check the status of automation jobs, view logs, and trigger manual generation when needed.

If you encounter issues, verify that the MCP server is running, ensure the Cursor client is connected, and confirm Node.js is installed. Review logs for daily and weekly automation as well as launcher-related messages to identify problems quickly.

Available tools

generate_daily_summary

Generate a concise daily productivity summary in HTML/Markdown or both, with an option to save to the summaries folder and include specific sections.

generate_weekly_summary

Generate a comprehensive weekly productivity summary for a chosen date range, with output formats and an option to save to the summaries folder.

get_quick_stats

Retrieve quick productivity metrics for a given period without generating a full summary.

list_summaries

List previously generated summaries with options to limit, sort, and filter by format.

get_summary

Retrieve a specific summary by filename or date range in HTML, Markdown, or both.

compare_periods

Compare productivity metrics between two time periods across selected metrics.