atlassian.com
atlassian.com logo

Atlassian

Integrates with Atlassian's Confluence and JIRA APIs to enable content creation, issue tracking, and project management...

Created byApr 23, 2025

MCP Atlassian

A Model Context Protocol (MCP) server that provides tools for interacting with Atlassian products (Confluence and Jira).

Overview

This MCP server allows AI agents to interact with Atlassian products through a standardized interface. It provides tools for:
  • **Confluence**: Search content, get spaces, retrieve content, and list pages
  • **Jira**: Search issues, get issue details, list projects, and more

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • Atlassian account with API token
  • Docker (optional, for containerized deployment)

Installation

Standard Installation

  1. Clone the repository: ```bash git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian ```
  1. Install dependencies: ```bash npm install # or using make make install ```
  1. Create a `.env` file in the root directory with your Atlassian credentials: ``` ATLASSIAN_HOST=https://your-domain.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token ```

Docker Installation

  1. Clone the repository: ```bash git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian ```
  1. Create a `.env` file as described above.
  1. Build and run the Docker container: ```bash # Build the Docker image make docker-build # Run the Docker container make docker-run # Or use Docker Compose make docker-compose ```

Usage

Starting the Server

This will start the MCP server, which will listen for requests on stdin and respond on stdout.

Available Tools

Confluence Tools

  • **search-confluence**: Search for content in Confluence using CQL - Parameters: `query` (string)
  • **get-confluence-space**: Get information about a specific Confluence space - Parameters: `spaceKey` (string)
  • **get-confluence-content**: Get specific content by ID - Parameters: `contentId` (string)
  • **get-confluence-pages**: Get all pages in a space - Parameters: `spaceKey` (string), `limit` (number, optional)

Jira Tools

  • **search-jira-issues**: Search for issues using JQL - Parameters: `jql` (string), `maxResults` (number, optional)
  • **get-jira-issue**: Get a specific issue by key - Parameters: `issueKey` (string)
  • **get-jira-projects**: Get all projects - Parameters: none
  • **get-jira-project**: Get a specific project by key - Parameters: `projectKey` (string)
  • **get-jira-issue-types**: Get all issue types - Parameters: none

Development

Project Structure

Building

Testing

Makefile Commands

The project includes a Makefile to simplify common operations:

License

MIT

Contributing

  1. Fork the repository
  1. Create your feature branch (`git checkout -b feature/amazing-feature`)
  1. Commit your changes (`git commit -m 'Add some amazing feature'`)
  1. Push to the branch (`git push origin feature/amazing-feature`)
  1. Open a Pull Request