Confluence and JIRA MCP server

Integrates with Confluence and JIRA APIs to enable querying and management of Atlassian project data, documentation, and issues.
Back to servers
Provider
zereight
Release date
Feb 11, 2025
Language
TypeScript
Package
Stats
918 downloads
11 stars

This Model Context Protocol (MCP) server enables integration with Confluence and Jira, allowing you to execute queries and manage content within these platforms. It provides a standardized way to interact with Confluence pages and Jira issues through the MCP client-server architecture.

Installation

Setting Up with Claude App, Cline, or Roo Code

Configure your MCP configuration file with the following settings:

{
  "mcpServers": {
    "Confluence communication server": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "CONFLUENCE_API_MAIL": "Your email",
        "CONFLUENCE_API_KEY": "KEY_FROM: https://id.atlassian.com/manage-profile/security/api-tokens",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Setting Up with Cursor

Via Smithery

You can install the Confluence MCP server automatically using Smithery:

npx -y @smithery/cli install @zereight/confluence-mcp --client claude

Manual Setup

To run the server with environment variables:

env [email protected] CONFLUENCE_API_KEY=your-key CONFLUENCE_URL=your-confluence-url JIRA_URL=your-jira-url npx -y @zereight/mcp-confluence

Environment Variables

Confluence Tools

Executing CQL Searches

Use the execute_cql_search tool to search for pages in Confluence:

{
  "cql": "space = DEV AND title ~ \"API Documentation\"",
  "limit": 20
}

Getting Page Content

Retrieve content from a specific Confluence page:

{
  "pageId": "123456789"
}

Creating Pages

Create a new page in Confluence:

{
  "spaceKey": "DEV",
  "title": "New API Documentation",
  "content": "<p>This is the page content in storage format.</p>",
  "parentId": "987654321"
}

Updating Pages

Update an existing Confluence page:

{
  "pageId": "123456789",
  "content": "<p>Updated content for the page.</p>",
  "title": "Updated API Documentation"
}

Jira Tools

Executing JQL Searches

Search for issues in Jira:

{
  "jql": "project = DEV AND status = \"In Progress\" AND assignee = currentUser()",
  "limit": 15
}

Creating Jira Issues

Create a new Jira issue:

{
  "project": "DEV",
  "summary": "Implement new feature",
  "description": "We need to implement the new feature as described in the requirements document.",
  "issuetype": "Task",
  "assignee": "user123",
  "priority": "High"
}

Updating Jira Issues

Update fields of an existing issue:

{
  "issueKey": "DEV-123",
  "summary": "Updated feature implementation",
  "description": "Updated description with more details",
  "assignee": "user456",
  "priority": "Medium"
}

Transitioning Issues

Change the status of a Jira issue:

{
  "issueKey": "DEV-123",
  "transitionId": "21"
}

Working with Sprints

Get all sprints from a board:

{
  "boardId": "123",
  "state": "active"
}

Get issues from a specific sprint:

{
  "sprintId": "456",
  "fields": ["summary", "status", "assignee"]
}

Get the current active sprint:

{
  "boardId": "123",
  "includeIssues": true
}

Epic Management

Get all issues belonging to an epic:

{
  "epicKey": "DEV-100",
  "fields": ["summary", "status", "assignee"]
}

User Issues

Get issues assigned to a specific user:

{
  "boardId": "123",
  "username": "john.doe",
  "type": "assignee",
  "status": "in_progress"
}

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later