Installation

Monday Morning is a context recovery layer for AI-assisted knowledge work. It stores structured project state in a .mm/ directory inside your repo so AI agents can pick up where you left off.

There are two main components:

CLI — Initialize projects, launch the desktop app, and manage updates from the terminal.
Desktop App — A native Tauri app for viewing specs, tasks, issues, and notes in a visual dashboard.

Prerequisites

Node.js 18+ — Required for the CLI. Check with node --version.
macOS, Windows, or Linux — The desktop app ships native binaries for all three platforms.

Install the CLI

The CLI is distributed as an npm package. Run the installer with npx:

npx @mondaymorning/cli install

This downloads the desktop app binary for your platform and sets up the mm command globally.

Once installed, verify it works:

mm --version

What the installer does

Detects your OS and architecture.
Downloads the latest desktop app binary from GitHub Releases.
Places it in the standard application directory for your platform.
Makes the mm command available in your terminal.

Download the Desktop App

If you prefer a manual install, download the latest release directly from GitHub:

https://github.com/WeekendDevsOrg/monday-morning/releases

Platform	Format
macOS (Apple Silicon)	`.dmg`
macOS (Intel)	`.dmg`
Windows	`.msi` / `.exe`
Linux	`.AppImage` / `.deb`

After installing, you can launch the app from your Applications folder or run mm from the terminal.

Configure the MCP Server

Monday Morning exposes 54+ tools to AI agents through the Model Context Protocol (MCP). To use these tools with your AI coding assistant, add the MCP server to your tool’s configuration.

Claude Code
Cursor

Add to your Claude Code MCP config (typically ~/.claude/claude_desktop_config.json or the project’s .mcp.json):

{
  "mcpServers": {
    "monday-morning": {
      "command": "node",
      "args": ["path/to/mcp-servers/monday-morning/dist/index.js"],
      "env": {
        "MM_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "monday-morning": {
      "command": "node",
      "args": ["path/to/mcp-servers/monday-morning/dist/index.js"],
      "env": {
        "MM_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Next Steps

Initialize a project — Set up .mm/ in your repository.
Understand the data model — Learn how Monday Morning stores project state.
Your first workflow — Create a spec, add tasks, and track progress end-to-end.