@kody/atlassian

@kody/atlassian

Official Atlassian mark. Atlassian®, Jira®, and Confluence® are trademarks of Atlassian Pty Ltd. This package is not affiliated with or endorsed by Atlassian.

Intent

Provide reusable Jira and Confluence helpers that prefer the official Atlassian MCP server (kody.mcp["atlassian"]) so onboarding is add-server-and-authorize, not register-an-OAuth-app. Fall back to the @kody/jira OAuth or API-token helpers when MCP is not connected.

This listing is meant to be forked. After you fork, connect your Atlassian site. Do not treat the live @kody/atlassian connection as yours.

Share this listing as https://kody.codes/@kody/atlassian

Required setup

Preferred: add the official Atlassian MCP server, then authorize it.

await kody.mcp_server_add({
  name: 'atlassian',
  url: 'https://mcp.atlassian.com/v1/mcp/authv2',
})

Open the returned authUrl. Helpers then call kody.mcp["atlassian"]. Do not register an Atlassian OAuth app for the one-click path.

Fallback: use @kody/jira for bring-your-own Atlassian OAuth 2.0 (3LO) or an API token plus account email. See https://kody.codes/@kody/jira

Exports

• kody:@kody/atlassian — package overview and MCP setup
• kody:@kody/atlassian/smoke-test — verify MCP (or report fallback setup)
• kody:@kody/atlassian/search-jira — search Jira issues you can already see
• kody:@kody/atlassian/search-confluence — search Confluence pages you can already see

Example

import searchJira from 'kody:@kody/atlassian/search-jira'

export default async function main() {
  return searchJira({
    jql: 'assignee = currentUser() ORDER BY updated DESC',
    maxResults: 10,
  })
}