Skip to main content
This guide provides step-by-step workflows for common tasks using MCP Atlassian tools.

​
Jira Workflows

​
Triage New Issues

  1. Find untriaged issues:
jira_search: {"jql": "project = PROJ AND status = 'Open' AND assignee IS EMPTY ORDER BY created DESC", "limit": 20}
  1. Review each issue to understand the problem:
jira_get_issue: {"issue_key": "PROJ-123", "comment_limit": 5}
  1. Assign and prioritize:
jira_update_issue: {"issue_key": "PROJ-123", "additional_fields": "{\"assignee\": {\"accountId\": \"user-id\"}, \"priority\": {\"name\": \"High\"}}"}
  1. Add a triage comment:
jira_add_comment: {"issue_key": "PROJ-123", "comment": "Triaged: High priority, assigned to backend team."}

​
Sprint Planning

  1. Get the board and active sprint:
jira_get_agile_boards: {"project_key": "PROJ", "board_type": "scrum"}

jira_get_sprints_from_board: {"board_id": "42", "state": "active,future"}
  1. Review current sprint progress:
jira_get_sprint_issues: {"sprint_id": "100", "fields": "summary,status,story_points,assignee"}
  1. Find backlog items for next sprint:
jira_search: {"jql": "project = PROJ AND sprint IS EMPTY AND status = 'Open' ORDER BY priority DESC, created ASC", "limit": 30}

​
Bulk Issue Creation

Create multiple related issues at once: 
jira_batch_create_issues: {
  "project_key": "PROJ",
  "issues": [
    {"issue_type": "Task", "summary": "Set up CI pipeline", "description": "Configure GitHub Actions"},
    {"issue_type": "Task", "summary": "Write unit tests", "description": "Add tests for core module"},
    {"issue_type": "Task", "summary": "Update documentation", "description": "Document new API endpoints"}
  ]
}

​
Track Issue Changes

Monitor what changed across multiple issues: 
jira_batch_get_changelogs: {"issue_keys": ["PROJ-1", "PROJ-2", "PROJ-3"]}
Changelog tracking is only available on Jira Cloud.

​
Confluence Workflows

​
Create Documentation Structure

  1. Create a parent page:
confluence_create_page: {"space_key": "DEV", "title": "Project Documentation", "content": "## Overview\n\nThis space contains all project docs."}
  1. Create child pages:
confluence_create_page: {"space_key": "DEV", "title": "API Reference", "content": "## API Endpoints\n\n...", "parent_id": "12345678"}
  1. Add labels for organization:
confluence_add_label: {"page_id": "12345678", "label": "api-docs"}

​
Content Migration

  1. Search for pages to migrate:
confluence_search: {"query": "space = OLD_SPACE AND label = 'migrate' ORDER BY title ASC"}
  1. Read each page’s content:
confluence_get_page: {"page_id": "12345678", "include_metadata": true}
  1. Create in new space:
confluence_create_page: {"space_key": "NEW_SPACE", "title": "Migrated Page", "content": "...migrated content..."}

​
Identify Stale Content

Find pages that haven’t been updated recently: 
confluence_search: {"query": "space = DEV AND type = page AND lastModified < '2024-01-01' ORDER BY lastModified ASC", "limit": 50}
Check page view analytics: 
confluence_get_page_views: {"page_id": "12345678"}

​
Cross-Product Workflows

  1. Create a Confluence page with project context:
confluence_create_page: {"space_key": "DEV", "title": "Sprint 42 Retrospective", "content": "## Sprint 42\n\nSee PROJ-100 through PROJ-120 for completed work."}
  1. Add a remote link from Jira to Confluence:
jira_create_remote_issue_link: {"issue_key": "PROJ-100", "url": "https://your-instance.atlassian.net/wiki/spaces/DEV/pages/12345678", "title": "Sprint 42 Retro"}