MCP Tools Reference
Monday Morning’s MCP server ships 46 built-in tools. The 24 core tools are advertised in tools/list by default; the remaining 22 long-tail tools are grouped and hidden from the listing until opted in, but every one still dispatches when called by name.
To advertise long-tail groups, set the MM_TOOL_GROUPS environment variable on the server (comma-separated group names, or all) — for example, in .mcp.json:
{ "env": { "MM_TOOL_GROUPS": "harvest,slack" } }Core (24) — listed by default
Section titled “Core (24) — listed by default”mm_search- Full-text search across all entity types (specs, features, issues, notes, ideas). Returns matchin…mm_configure_integration- Configure an external service integration (github, trello, grain, gmail, notion). Sets config in …mm_sync_notion- Bidirectional sync between a Notion database and .mm/specs/ or .mm/notes/. Pulls Notion pages int…mm_daily_brief- Generate a structured morning summary with active tasks, blockers, recently completed tasks, open…mm_revert_spec_completion- Revert a spec’s completion status in its parent feature. Tasks stay [x] but the spec is no longer…mm_claim_spec- Claim a spec from a teammate. Records the claim in the cloud (first-claim-wins). Use when you wan…mm_fetch_claims- Fetch all spec claims for your team. Shows which specs have been claimed, by whom, and from whom.mm_team_radar- Collision radar — before starting a spec/branch, check whether a teammate is already on it: activ…mm_order_specs- Deterministic spec ordering: reads all specs, parses depends_on frontmatter, runs topological sor…mm_check_tier- Check the current license tier (free/pro/team) from the shared credential store. Returns TierInfo…mm_retrieve_prior_work- Regenerate prior-work.md for an existing spec by re-running similarity retrieval against the curr…mm_index- Rebuild or health-check the ledger semantic embedding index (.mm/index/ledger/) used by mm_search…mm_create- Create a Monday Morning entity. Theentitydiscriminator chooses the per-type handler. Replaces…mm_list- List a collection of Monday Morning entities. Theentitydiscriminator chooses the per-type lis…mm_get- Read a single Monday Morning entity or computed view. Theentitydiscriminator chooses the per-…mm_update- Update a Monday Morning entity. Theentitydiscriminator chooses the per-type updater. Replaces…mm_complete- Complete a Monday Morning entity with cascading rollups. Theentitydiscriminator chooses the p…mm_link- Create a link between Monday Morning entities. Theentitydiscriminator chooses the per-link-ty…mm_move- Move Monday Morning entities between states/sections. Theentitydiscriminator chooses the per-…mm_archive- Archive a Monday Morning entity (soft delete). Theentitydiscriminator chooses the per-type ar…mm_verify- Run an iterative verify-spec pipeline phase.start_run/finish_rundelimit a measured run; the…mm_run- Session runtime for a /mm: command run.phaseselects the operation.logappends one typed ev…mm_record- Record what this session learned into a spec’s## Recordedblock — the durable, append-only sub…mm_send_peer_message- Send an advisory message to a peer MM session on this machine — the host delivers it as a clearly…
Docs (2) — opt-in group docs
Section titled “Docs (2) — opt-in group docs”mm_delete_doc- Delete a doc file and remove its entry from the docs.md dashboard. This is destructive — use mm_a…mm_export_doc- Export a doc to .docx (Word), Google Docs compatible HTML, or Slack mrkdwn format. For docx, save…
Imports (4) — opt-in group imports
Section titled “Imports (4) — opt-in group imports”mm_import_skill- Import an external skill from an HTTPS URL or local .md file into .claude/skills/. Validates cont…mm_sync_github- Bidirectional sync between GitHub issues and .mm/issues/. Pulls open GitHub issues into MM format…mm_import_meeting_notes- Import meeting notes from Grain. Fetches meeting by ID or searches by query/date range, creates …mm_save_grain_note- Save a Grain meeting note to the central grain notes store at ~/.monday-morning/grain/notes/. Ded…
Trello (3) — opt-in group trello
Section titled “Trello (3) — opt-in group trello”mm_import_trello- Import Trello cards as tasks and issues. Maps cards from configured board lists into spec impleme…mm_export_trello- Export spec progress to linked Trello cards. Posts progress comments and updates card description…mm_sync_trello- Full bidirectional Trello sync. Detects card list changes and updates MM task statuses (reverse s…
Workflow (8) — opt-in group workflow
Section titled “Workflow (8) — opt-in group workflow”mm_plan_feature- Create a complete feature scaffold in one call — creates the feature, creates each spec (with spe…mm_suggest_next- Recommend what to work on next based on in-progress tasks, feature priority, task size, and stale…mm_start_task- Mark a task as in-progress and return context for starting work — spec content, requirements, sub…mm_save_session- Save current working context for later recovery. Captures all in-progress tasks and current spec…mm_restore_session- Load saved session context with enriched current status. Returns last session’s context with whet…mm_reload_plugins- Hot-reload community plugins from ~/.monday-morning/plugins/. Discovers newly installed plugins w…mm_mark_notifications_read- Mark specific notifications or all notifications as read.mm_preview_status- List the project’s currently-running local previews and their live URLs (as shown in the Monday M…
Team (3) — opt-in group team
Section titled “Team (3) — opt-in group team”mm_push_team_checkin- Push a team check-in to the cloud. Scans local specs and features, captures current branch, and u…mm_fetch_team_checkins- Fetch all team members’ check-ins from the cloud. Returns display names, branches, specs, feature…mm_team_refresh- Re-read the LIVE team activity for this project mid-session: teammates’ active agent sessions, wh…
Handoff (2) — opt-in group handoff
Section titled “Handoff (2) — opt-in group handoff”mm_handoff- Hand off a spec to another agent in the same roster: transfers the claim, the spec and the record…mm_resume- Resume a session on this machine: moves the transcript here and marks the originating session non…
Plugin tools (20)
Section titled “Plugin tools (20)”mm_get_design_tokens- Retrieve the projectmm_sync_github- Sync issues bidirectionally between GitHub and Monday Morningmm_link_github_pr- Link a GitHub pull request to a task in a specmm_import_meeting_notes- Import meeting notes from Grain into the project. Supports importing by meeting ID, search query,…mm_save_grain_note- Save a Grain meeting note locally as markdown. Handles deduplication via meeting ID and tracks pr…mm_get_project_meeting_context- Retrieve recent meeting context for a project. Returns summaries, decisions, and open action item…mm_harvest_aggregate_time- Aggregate time entries from Harvest, optionally grouped by user, task, or date.mm_harvest_compute_budget_performance- Compute budget performance metrics for a Harvest project, comparing actual hours against budgeted…mm_harvest_compute_profitability- Compute profitability metrics for a Harvest project, including revenue, costs, and margins.mm_harvest_compute_utilization- Compute team or individual utilization rates from Harvest time entries.mm_harvest_list_projects- List all projects from Harvest, optionally filtered by active status.mm_harvest_list_time_entries- List time entries from Harvest, optionally filtered by project, user, and date range.mm_migrate_obsidian- Backfill Obsidian-compatible YAML frontmatter on all .mm/ entities and generate .obsidian/ vault …mm_slack_post_update- Post a formatted message to a Slack channel. Reads bot token from .mm/integrations/slack.json. Su…mm_slack_digest- Generate and post a formatted activity digest to a Slack channel. Reads project activity data and…mm_slack_ingest- Ingest messages from a Slack channel (excluding bot messages) into the project inbox. Captures me…mm_start_voice_input- Initialize voice input system and start listening for commands or dictationmm_process_voice_command- Process a voice command transcript and execute the corresponding actionmm_configure_voice_settings- Update voice assistant configurationmm_get_voice_stats- Get voice assistant usage statistics
Plugins
Section titled “Plugins”- Design Tokens - Point at your project (1 tools)
- GitHub Integration - Tie code to plans — sync GitHub issues with project tasks and link pull requests directly to spec… (2 tools)
- Google Calendar - Preview integration: connect a Google Calendar so future builds can pull meeting context into bri… (0 tools)
- Grain Meetings - Pull Grain meeting transcripts into your projects so action items, decisions, and discussion cont… (3 tools)
- Harvest Time Tracking - Pull tracked hours and budgets from Harvest into each project so you can see burn rate, profitabi… (6 tools)
- Notion Integration - Pull your assigned Notion database tasks into Monday Morning so the work tracked in Notion shows … (0 tools)
- Obsidian Integration - Preview integration: the migration tool exists (mm_migrate_obsidian) and works when invoked by Cl… (1 tools)
- Slack Integration - Push project updates and activity digests into Slack so your team sees status without checking th… (3 tools)
- Trello Integration - Mirror Trello cards into Monday Morning tasks so the board your team uses stays in sync with your… (0 tools)
- Voice Assistant - Hands-free voice control for Monday Morning. Create specs, manage tasks, and navigate your projec… (4 tools)