Activity

Open Source — GitScrum MCP Server is open source under the MIT license. Available on npm and GitHub. Model Context Protocol server for GitScrum — Claude, GitHub Copilot, Cursor, and any MCP-compatible client full operational access to your project management stack.

The activity tool provides 5 actions for monitoring project activity streams at every level — from individual task changes to workspace-wide event feeds. Every action your team takes in GitScrum generates an activity record, and the MCP Server gives your AI assistant full access to this audit trail through natural language queries.

Activity feeds capture task updates, status changes, comments, assignments, sprint actions, and all other project events. Whether you need a quick check on what happened while you were away or a comprehensive audit trail for compliance, the activity tool provides the right scope and granularity.

Actions Overview

Project Activity

The project action returns the activity stream for a specific project — all task updates, status changes, comments, sprint events, and team actions within that project. Results are ordered chronologically with the most recent activity first.

Parameters

You:  "Show recent project activity for the Backend project"
AI:   Calls activity action=project → returns chronological activity feed

You:  "What happened on the Backend project today?"
AI:   Calls activity action=project → AI filters for today's entries

You:  "Were there any status changes on the Mobile App project this week?"
AI:   Calls activity action=project → AI filters for status change events

Task Activity

The task action returns the complete activity history for a specific task — every change, comment, assignment, status transition, and update since the task was created. This is the full audit trail for a single work item.

Parameters

You:  "What happened on task PROJ-42?"
AI:   Looks up task by code → calls activity action=task
      → returns complete task history with all changes

You:  "Show me the full history of the payment integration task"
AI:   Resolves task → calls activity action=task
      → returns chronological list of all events

You:  "Who changed the priority on PROJ-42?"
AI:   Calls activity action=task → AI identifies the priority change event and author

You:  "When was this task moved to In Progress?"
AI:   Calls activity action=task → AI finds the status change event with timestamp

User Activity

The user action returns the activity feed for a specific team member — all their actions across projects within the workspace. This is useful for understanding individual contributions, preparing performance reviews, or tracking what a colleague has been working on.

Parameters

You:  "What has John been working on?"
AI:   Calls activity action=user with username="john"
      → returns John's recent activity across all projects

You:  "Show my recent activity"
AI:   Calls activity action=user → returns your own activity feed

You:  "What did Sarah do on the Backend project last week?"
AI:   Calls activity action=user with username="sarah"
      → AI filters results to Backend project and last week's timeframe

Workspace Activity

The workspace action returns the activity feed across the entire workspace — every event from every project. This provides the broadest view of organizational activity, useful for workspace administrators and managers overseeing multiple projects.

Parameters

You:  "Show workspace-wide activity feed"
AI:   Calls activity action=workspace → returns cross-project activity stream

You:  "What's happening across all projects right now?"
AI:   Calls activity action=workspace → AI summarizes recent activity by project

You:  "Any critical changes across the workspace today?"
AI:   Calls activity action=workspace → AI filters for high-impact events

Aggregated Feed

The feed action returns a combined, aggregated activity feed that merges events from multiple sources into a unified stream. This is similar to workspace but optimized for consumption — events are grouped and deduplicated for easier scanning.

Parameters

You:  "Show me the activity feed"
AI:   Calls activity action=feed → returns aggregated activity stream

You:  "Give me a summary of what the team did today"
AI:   Calls activity action=feed → AI summarizes and groups by team member or project

Activity Monitoring Patterns

Activity feeds serve different purposes depending on your role and context. Here are common monitoring patterns:

Daily Catch-Up

When you start your day, use the project or workspace feed to see what happened while you were away.

You:  "What happened on the Backend project since yesterday?"
AI:   Calls activity action=project → AI filters for events since yesterday
      → "12 events: 3 tasks completed, 2 new tasks created, 4 comments,
         2 status changes, 1 sprint update"

Task Investigation

When you need to understand why a task is in its current state, the task activity provides the complete history.

You:  "Why is PROJ-42 blocked?"
AI:   Calls activity action=task → reviews history for blocker events
      → "PROJ-42 was moved to Blocked 2 days ago by Sarah.
         Comment: 'Waiting on third-party API access credentials'"

Team Performance Review

Use user activity feeds to prepare for 1:1 meetings or performance reviews.

You:  "Summarize Mike's contributions this month"
AI:   Calls activity action=user with username="mike"
      → AI aggregates: tasks completed, PRs reviewed, comments added

You:  "Compare team activity levels this week"
AI:   Calls activity action=workspace → AI groups by user and counts actions

Change Monitoring

Track specific types of changes across the workspace for governance or compliance.

You:  "Were any tasks deleted this week?"
AI:   Calls activity action=workspace → AI filters for deletion events

You:  "Who made changes to Sprint 14?"
AI:   Calls activity action=project → AI filters for sprint-related events

Audit Trail Use Cases

Activity data serves as a comprehensive audit trail for your projects. Common audit scenarios:

• Compliance reporting. Export activity data to demonstrate who changed what and when. Every action includes a timestamp, actor, and description of the change.
• Incident investigation. When something goes wrong, trace back through activity history to identify the root cause — what changed, who changed it, and when.
• Decision documentation. Task activity captures comments and status changes that document the reasoning behind decisions. Use activity action=task to reconstruct the decision timeline.
• Workload analysis. Aggregate user activity data to understand work distribution across the team. Identify overloaded or underutilized team members.

Pagination

For projects with high activity volume, results are paginated. Use the page and per_page parameters to navigate through results. The AI assistant handles pagination automatically when you ask for comprehensive data.

You:  "Show me all activity for the Backend project this month"
AI:   Calls activity action=project → pages through results as needed
      → returns consolidated activity summary

Next Steps

• Analytics: Access structured project health and performance reports.
• Standup: Review daily standups alongside activity feeds.
• Budget: Monitor financial activity and budget changes.
• Tasks: Manage the tasks that generate activity events.