README.md
Atlassian MCP Server for Heroku
A Model Context Protocol (MCP) server for Jira and Confluence integration.
Features
- Jira - Search issues, create/update tickets, manage sprints and boards
- Confluence - Search and manage documentation pages
- Heroku Native - Designed for Heroku deployment with MCP process support
Available Tools
Jira Tools
| Tool | Description |
|---|---|
jira_search_issues |
Search using JQL |
jira_get_issue |
Get issue details |
jira_create_issue |
Create new issue |
jira_update_issue |
Update issue fields |
jira_transition_issue |
Change issue status |
jira_add_comment |
Add comment to issue |
jira_list_projects |
List all projects |
jira_list_boards |
List agile boards |
jira_list_sprints |
List sprints for a board |
Confluence Tools
| Tool | Description |
|---|---|
confluence_list_spaces |
List all spaces |
confluence_get_page |
Get page content |
confluence_search |
Search with CQL |
confluence_create_page |
Create new page |
confluence_update_page |
Update page content |
Deployment
One-Click Deploy
Click the "Deploy to Heroku" button above.
Configure Credentials
heroku config:set ATLASSIAN_DOMAIN=your-company.atlassian.net
heroku config:set ATLASSIAN_EMAIL=your-email@company.com
heroku config:set ATLASSIAN_API_TOKEN=your-api-token
Get your API token at https://id.atlassian.com/manage-profile/security/api-tokens
Register with Heroku AI
heroku addons:attach your-main-app::INFERENCE -a my-atlassian-mcp
Usage
response = client.chat.completions.create(
model=os.getenv("INFERENCE_MODEL_ID"),
messages=[
{"role": "user", "content": "Find all open bugs in project MYPROJ"}
],
extra_body={
"heroku": {
"mcp_servers": ["mcp-atlassian"]
}
}
)
License
MIT
Tools 14
jira_search_issuesSearch using JQLjira_get_issueGet issue detailsjira_create_issueCreate new issuejira_update_issueUpdate issue fieldsjira_transition_issueChange issue statusjira_add_commentAdd comment to issuejira_list_projectsList all projectsjira_list_boardsList agile boardsjira_list_sprintsList sprints for a boardconfluence_list_spacesList all spacesconfluence_get_pageGet page contentconfluence_searchSearch with CQLconfluence_create_pageCreate new pageconfluence_update_pageUpdate page contentEnvironment Variables
ATLASSIAN_DOMAINrequiredYour Atlassian instance domain (e.g., your-company.atlassian.net)ATLASSIAN_EMAILrequiredThe email address associated with your Atlassian accountATLASSIAN_API_TOKENrequiredAPI token generated from your Atlassian security settingsTry it
→Find all open bugs in project MYPROJ
→List the active sprints for the engineering board
→Create a new Jira ticket for the login page bug with high priority
→Search Confluence for documentation regarding the new API authentication flow
→Add a comment to issue PROJ-123 saying that the fix is currently in testing