MCP Server

🚀 GitScrum MCP Server: Your AI Agent as a Project Manager 🚀

Transform your AI Agent into a comprehensive Project Manager. The Official Model Context Protocol (MCP) server for GitScrum equips AI assistants (such as Claude, Cursor, Windsurf, Copilot) with in - depth context and operational access to your entire project stack.

🚀 Quick Start

Installation Options

⚡ Hosted (Recommended)

Zero install. Works everywhere.

https://mcp.gitscrum.com/sse

This SSE - based server is hosted on AWS. Simply add the URL + token to your AI client. Best for: Claude Desktop, Cursor, Windsurf, any SSE - compatible client. → Setup Guide

📦 Local (npm)

Self - hosted via npx.

npx -y @gitscrum-studio/mcp-server

It runs locally via stdio transport and requires Node.js 18+. Best for: VS Code, GitHub Copilot, offline environments. → Local Setup

Configuration Steps

Install

npx -y @gitscrum-studio/mcp-server

Configure your client

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

{
  "servers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Authenticate

Tell your AI assistant: "Login to GitScrum" The server initiates an OAuth 2.0 Device Authorization Grant flow. You authorize in the browser — credentials are never shared with the MCP server.

✨ Features

GitScrum Studio MCP Server connects AI assistants to your GitScrum workspace via the Model Context Protocol. It provides Claude, GitHub Copilot, Cursor, and any MCP - compatible client with full operational access to your project management stack, including tasks, sprints, time tracking, user stories, epics, kanban workflows, team discussions, wiki, notes, client CRM, invoicing, proposals, budget tracking, analytics dashboards, standup reports, and activity feeds.

Here are some examples of interactions:

You:    "What's on my plate today?"
Assistant: Fetches your tasks due today across all projects.

You:    "Create a sprint for next week with the top 5 backlog items"
Assistant: Creates the sprint, assigns tasks, and sets the timeline.

You:    "Show me which projects are over budget"
Assistant: Returns burn - down data and flags at - risk projects.

You:    "Send the Q1 proposal to Acme Corp"
Assistant: Creates the proposal, attaches the client, and sends it.

You:    "What did the team ship this week?"
Assistant: Generates a standup digest with completed work and blockers.

29 tools. 160+ operations. Zero context switching.

📦 Tools

Each tool uses a consolidated action parameter, reducing LLM context tokens by ~80% compared to individual tool definitions.

Core

Planning

Collaboration

ClientFlow CRM

Insights ^PRO

Authentication

Full reference: docs/TOOLS.md

🔧 Security

The server is designed around the principle of least privilege.

Destructive operations must be performed in the GitScrum Studio.

Full details: docs/SECURITY.md

Found a vulnerability? Report privately to security@gitscrum.com.

📚 Documentation

💻 Development

git clone https://github.com/gitscrum-core/mcp-server.git
cd mcp-server
npm install
npm run build
npm test          # 378 tests across 22 suites

Inspect locally with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Full guide: docs/DEVELOPMENT.md

🤝 Contributing

See CONTRIBUTING.md for guidelines.

git checkout -b feature/my-feature
# make changes, add tests
npm test
git commit -m "feat: describe your change"

📄 License

MIT — see LICENSE.

Website  ·  Docs  ·  Issues  ·  Changelog

Built by GitScrum