# GitScrum MCP > GitScrum manages your entire organizational structure inside GitScrum. Use this MCP to list workspaces, create new projects, configure Kanban workflows, or update labels—all by asking your AI client questions. You can map out complex project backbones and audit team progress without ever leaving your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workspace-management, kanban-boards, workflow-configuration, project-setup, label-organization, team-structure ## Description This connection lets you treat your entire organization's workflow management system like a simple database query. Instead of navigating through multiple dashboards, clicking into separate workspace views, or manually auditing status across different tabs, you just talk to it. Your agent handles the context switching for you. You can ask it to list all available workspaces and then immediately pull up every project within that space, giving you an instant map of what's going on. Want to set up a new initiative? Just prompt your agent; it creates the whole structure—the workspace, the project, and the default workflow columns—in one go. If you find yourself wishing your AI client could connect to more services like this, check out Vinkius, the #1 MCP Catalog, where you can link up dozens of tools. ## Tools ### list_labels Lists all available labels associated with a given project. ### get_me Retrieves the profile information of the authenticated user. ### list_project_members Retrieves the full list of team members assigned to an active project. ### my_role Gets the user's specific role and permissions within the current workspace. ### create_project Makes a brand new project within GitScrum. ### find_project Locates and pulls details for a specific project by its name. ### get_project Gets detailed information about a specific project. ### list_projects Shows all projects contained within a specific workspace. ### project_stats Calculates and returns key statistics for a given project. ### get_task Fetches all details for a task using its unique UUID. ### list_tasks Filters and lists tasks in a project based on their status (To Do, In Progress, Done). ### list_workflows Lists all available Kanban column definitions for a project. ### create_workspace Sets up an entirely new organizational workspace. ### get_workspace Retrieves the full details of a specific workspace. ### list_workspaces Retrieves an exhaustive list of every accessible GitScrum workspace. ### workspace_stats Gathers overall usage metrics and data points for an entire workspace. ## Prompt Examples **Prompt:** ``` Show me all the workspaces I have access to on GitScrum. ``` **Response:** ``` I found 3 workspaces on your account: 'Acme Engineering' (slug: acme-eng), 'Design Studio' (slug: design-studio), and 'Internal Ops' (slug: internal-ops). The first one has 12 active projects. Which workspace would you like to explore? ``` **Prompt:** ``` Create a new project called 'Mobile App v2' in the acme-eng workspace with a description. ``` **Response:** ``` Done! 'Mobile App v2' has been created in the acme-eng workspace with slug 'mobile-app-v2'. It's set up with the default workflow columns: To Do, In Progress, Review, and Done. Shall I add custom labels or invite team members? ``` **Prompt:** ``` What labels are available in the web-app project? ``` **Response:** ``` The web-app project has 5 labels: 🔴 'Critical' (#E74C3C), 🟡 'Enhancement' (#F39C12), 🔵 'Frontend' (#3498DB), 🟢 'Backend' (#27AE60), and 🟣 'DevOps' (#9B59B6). Would you like to create additional labels or apply any of these to tasks? ``` ## Capabilities ### Map Organizational Structure List all workspaces and retrieve details for every project within those spaces. ### Project Lifecycle Management Create new projects from scratch or fetch full metadata, including members and settings. ### Workflow Auditing View existing Kanban column definitions and manage project workflows using templates. ### Task and Member Lookup Find specific tasks by UUID or list every team member assigned to a given project. ### Categorize Workload List, create, and update color-coded labels to keep track of different work types across projects. ## Use Cases ### The Quarterly Audit An Engineering Manager needs to know how many active projects exist across all departments. They ask their agent to run `list_workspaces` followed by `list_projects`. The agent compiles the data and gives a single, actionable report, saving hours of manual navigation. ### New Feature Kickoff A Team Lead starts a new initiative. They prompt their agent to run `create_project` for 'Mobile App v3'. The agent confirms the creation and automatically sets up the default workflow columns, allowing them to add tasks immediately. ### Resource Bottleneck Check A Product Developer needs to know who is assigned to a critical project. They ask the agent to use `list_project_members` and instantly get the full team roster, skipping manual lookups. ### Status Report Generation An executive asks for all incomplete work in the 'Web App' line. The agent runs `list_tasks` filtered by status (e.g., 'In Progress') and delivers a clean, summarized list of tasks needing attention. ## Benefits - Audit the whole structure instantly. Instead of manually checking dashboards, ask your agent to run `list_workspaces` and then `list_projects` to get a full inventory of all initiatives across the company. - Eliminate setup bottlenecks. Need a new project? Use `create_project` or `create_workspace`, and the system builds out the default workflow columns so you can start working immediately. - Get crystal clear on scope. Instead of guessing, use `list_tasks` to filter by status (like 'To Do' or 'In Progress') and see exactly what work is blocked or waiting for review. - Deep dive into team details. Need a headcount? Your agent can call `list_project_members` so you don't have to manually check roles across multiple tabs. - Understand the whole picture. Run `workspace_stats` to get high-level metrics, then use `project_stats` to drill down and see exactly which project is driving most of the current workload. ## How It Works The bottom line is that your AI agent becomes the single command center for managing GitScrum’s entire organizational backbone. 1. Subscribe to the GitScrum integration via Vinkius Marketplace. 2. Generate a personal API token in GitScrum Settings and provide it, along with your company slug, to your AI client. 3. Start asking your agent natural language questions like 'List all projects in my Design Studio workspace,' or 'Create a new project for Mobile App v3.' ## Frequently Asked Questions **How do I find all available projects in GitScrum using list_projects?** You tell your agent which workspace you're interested in, and then ask it to use `list_projects`. It returns a filtered list of every project within that specific organizational container. **Does the GitScrum MCP support getting task details by UUID?** Yes. You can provide the unique ID (UUID) and ask your agent to use `get_task`. This gives you immediate, comprehensive data on that single piece of work. **Can I check my role in GitScrum using my_role?** Absolutely. Just prompt the agent with 'What is my role?' and it executes `my_role`, telling you exactly what permissions your account has within that workspace. **How do I get overall statistics for all workspaces in GitScrum?** You first ask it to run `list_workspaces` to see everything. Then, if you want metrics, you prompt the agent with `workspace_stats`, which aggregates the top-level data. **What does using the get_me tool verify about my connection setup?** Yes, it confirms your login status. Running get_me pulls and displays the authenticated user's profile details across all connected workspaces. This is a quick way to validate that your API token and company slug are working correctly before running complex tasks. **If I need to separate teams, how does create_workspace help me?** It establishes a new organizational container. Using create_workspace generates an entirely isolated environment for a new team or client group. This keeps data clean and prevents cross-pollination between different work streams. **How can I check who is on a project team using list_project_members?** It retrieves the full list of users assigned to that specific project. This function provides member names and their associated roles, letting you quickly audit the entire team roster without manual checks. **How do I see every workspace available in GitScrum using list_workspaces?** It lists all organizational workspaces attached to your account. This function shows you the top-level structure, giving you a clean overview of every project container you have access to manage. **Can my AI agent list all workspaces and drill into specific project details?** Absolutely. Use `list_workspaces` to browse all your organizational workspaces, then `list_projects` to see every project within a workspace. Your agent returns full metadata including member counts, settings, and creation dates — all without leaving your conversation. **I need to set up a new project with custom workflows and labels — can I do it all conversationally?** Yes. Tell your agent to create the project, then ask it to configure the workflow columns and create color-coded labels. The agent chains `create_project`, `list_workflows`, and `create_label` tools automatically to set up your board exactly as you describe it. **Does this integration let me modify or delete projects?** This core integration focuses on workspace exploration, project creation, and configuration management — including workflows and labels. For task-level operations like CRUD, subtasks, and checklists, use the dedicated GitScrum Tasks integration. All actions respect your GitScrum account permissions.