MCP Atlassian Tool
Full Jira and Confluence integration. Provides tools for reading, searching, and managing issues, pages, sprints, boards, and more.
- Tech: Python, FastMCP framework, mcp-atlassian package
- Auth: Per-user OAuth/PAT tokens via
UserTokenMiddleware(cached, TTL: 300s)
Jira Tools
| Tool | Description |
|---|---|
| Search issues | JQL-based issue search |
| Get issue | Get issue details by key |
| Create issue | Create a new issue |
| Update issue | Update issue fields |
| Add comment | Add comment to issue |
| Get comments | Get issue comments |
| Transition issue | Change issue status |
| Get transitions | List available transitions |
| Get sprints | Get sprints for a board |
| Get board issues | Get issues on a board |
| Get epics | List epics |
| Get epic issues | Get issues in an epic |
| Get worklogs | Get time tracking entries |
| Add worklog | Log time on an issue |
| Get attachments | List issue attachments |
| Get projects | List projects |
| Get fields | List available fields |
| Get users | Search users |
| Get links | Get issue links |
Confluence Tools
| Tool | Description |
|---|---|
| Search pages | Search Confluence content |
| Get page | Get page content by ID |
| Create page | Create a new page |
| Update page | Update page content |
| Get spaces | List spaces |
| Get comments | Get page comments |
| Add comment | Add comment to page |
| Get labels | Get page labels |
| Add label | Add label to page |
| Get users | Search Confluence users |
Read-Only Mode
The server supports a read-only mode that filters out all write tools (create, update, delete, add). Configured via environment variable.
Tool Filtering
Individual tools can be selectively enabled or disabled via configuration.
Authentication
Uses per-user authentication via a middleware that validates tokens from the request:
- Supports OAuth tokens and Personal Access Tokens (PAT)
- Token validation results are cached (TTL: 300s)
- Health endpoint at
/healthz