---

name: atlassian description: Interact with Jira and Confluence via REST API - search, create, update issues and pages

Atlassian Skill

Access Jira and Confluence directly via REST APIs. This skill provides full CRUD operations for issues and pages without requiring the MCP server.

Authentication

Requires environment variables in .env:

• ATLASSIAN_SITE - Your Atlassian site (e.g., yourcompany.atlassian.net)
• ATLASSIAN_EMAIL - Your Atlassian account email
• ATLASSIAN_API_TOKEN - API token from https://id.atlassian.com/manage-profile/security/api-tokens

Available Scripts

Jira

Search Issues

Copynpx tsx scripts/jira-search.ts "<JQL query>" [maxResults] [nextPageToken]

Examples:

• npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"
• npx tsx scripts/jira-search.ts "project = PROJ AND type = Bug" 50
• npx tsx scripts/jira-search.ts "project = PROJ" 50 "token..." (pagination)

See docs/jql-guide.md for JQL syntax reference.

Get Issue Details

Copynpx tsx scripts/jira-get.ts <issueKey>

Example: npx tsx scripts/jira-get.ts PROJ-123

Create Issue

Copynpx tsx scripts/jira-create.ts '<JSON>'

Single issue:

Copynpx tsx scripts/jira-create.ts '{"project": "PROJ", "type": "Story", "summary": "New feature", "description": "Details here"}'

Bulk create (array):

Copynpx tsx scripts/jira-create.ts '[{"project": "PROJ", "type": "Bug", "summary": "Bug 1"}, {"project": "PROJ", "type": "Bug", "summary": "Bug 2"}]'

Update Issue

Copynpx tsx scripts/jira-update.ts <issueKey> '<JSON updates>'

Example: npx tsx scripts/jira-update.ts PROJ-123 '{"status": "In Progress", "assignee": "user@example.com"}'

Comments

Copy# Get comments
npx tsx scripts/jira-comment.ts <issueKey> get

# Add comment
npx tsx scripts/jira-comment.ts <issueKey> add "<comment text>"

Confluence

Search Pages

Copynpx tsx scripts/confluence-search.ts "<CQL query>" [maxResults]

Examples:

• npx tsx scripts/confluence-search.ts "title ~ 'Roadmap'"
• npx tsx scripts/confluence-search.ts "space = DEV AND type = page" 25

See docs/cql-guide.md for CQL syntax reference.

Get Page Content

Copynpx tsx scripts/confluence-get.ts <pageId>
# or by title
npx tsx scripts/confluence-get.ts --title "<page title>" --space <spaceKey>

Create Page

Copynpx tsx scripts/confluence-create.ts '<JSON>'

Example:

Copynpx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "New Page", "body": "<p>Content here</p>"}'

Optional parent page:

Copynpx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "Child Page", "body": "<p>Content</p>", "parentId": "123456"}'

Update Page

Copynpx tsx scripts/confluence-update.ts <pageId> '<JSON updates>'

Example: npx tsx scripts/confluence-update.ts 123456 '{"title": "Updated Title", "body": "<p>New content</p>"}'

Query Language References

For generating correct queries:

• Jira: Read docs/jql-guide.md for JQL syntax, fields, operators, and functions
• Confluence: Read docs/cql-guide.md for CQL syntax and fields

Common Workflows

Find and update my open issues

1. Search: npx tsx scripts/jira-search.ts "assignee = currentUser() AND status != Done"
2. Update: npx tsx scripts/jira-update.ts PROJ-123 '{"status": "Done"}'

Create issues from a list

1. Bulk create: npx tsx scripts/jira-create.ts '[{...}, {...}, {...}]'

Find and read documentation

1. Search: npx tsx scripts/confluence-search.ts "title ~ 'API Documentation'"
2. Get content: npx tsx scripts/confluence-get.ts 123456

Create a new documentation page

1. Create: npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "API Guide", "body": "<h1>API Guide</h1><p>...</p>"}'