mcp-atlassian
MCP server to interact with Atlassian products (currently supporting Confluence).
Features
Tools
- search_confluence: Search Confluence content using natural language
- get_page_content: Get content of a specific Confluence page
- get_page_comments: Get comments for a specific page
Example prompts
- "Search for all documentation related to authentication and summarize the key points"
- "Get the content of the onboarding guide and create a checklist from it"
- "Find all comments on the project requirements page and highlight any concerns raised"
Installation
# Using pip
pip install mcp-atlassian
# Or using uv (recommended)
uv pip install mcp-atlassian
Setup
Requirements
Create a .env file with:
CONFLUENCE_CLOUD_URL=your_confluence_url
CONFLUENCE_CLOUD_USER=your_username
CONFLUENCE_CLOUD_TOKEN=your_api_token
To get an API token:
- Log in to https://id.atlassian.com/manage-profile/security/api-tokens
- Click Create API token
- Enter a memorable Label for your token and click Create
- Click Copy to clipboard to save your token securely
Claude Desktop Configuration
Location:
- MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
Configuration
Development/Unpublished Servers Configuration
{
"mcpServers": {
"mcp-atlassian": {
"command": "uv",
"args": [
"--directory",
"<dir_to>/mcp-atlassian",
"run",
"mcp-atlassian"
],
"env": {
"CONFLUENCE_CLOUD_URL": "your_confluence_url",
"CONFLUENCE_CLOUD_USER": "your_username",
"CONFLUENCE_CLOUD_TOKEN": "your_api_token"
}
}
}
}
Published Servers Configuration
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": [
"mcp-atlassian"
],
"env": {
"CONFLUENCE_CLOUD_URL": "your_confluence_url",
"CONFLUENCE_CLOUD_USER": "your_username",
"CONFLUENCE_CLOUD_TOKEN": "your_api_token"
}
}
}
}
Development
Building
# Install dependencies
uv sync
# Build package
uv build
# Publish to PyPI
uv publish
Debugging
Use MCP Inspector:
npx @modelcontextprotocol/inspector mcp-atlassian
View logs:
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-atlassian.log
Todo
- Jira integration
Configuration
Development/Unpublished Servers Configuration
{
"mcpServers": {
"mcp-atlassian": {
"command": "uv",
"args": [
"--directory",
"<dir_to>/mcp-atlassian",
"run",
"mcp-atlassian"
],
"env": {
"CONFLUENCE_CLOUD_URL": "your_confluence_url",
"CONFLUENCE_CLOUD_USER": "your_username",
"CONFLUENCE_CLOUD_TOKEN": "your_api_token"
}
}
}
}
Published Servers Configuration
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": [
"mcp-atlassian"
],
"env": {
"CONFLUENCE_CLOUD_URL": "your_confluence_url",
"CONFLUENCE_CLOUD_USER": "your_username",
"CONFLUENCE_CLOUD_TOKEN": "your_api_token"
}
}
}
}
Legal & Security
This is not an official Atlassian product. Licensed under MIT - see LICENSE file.
Security
- Never share API tokens
- Keep .env files secure and private
- See SECURITY.md for best practices
For security issues, please email [security contact].
1 maintainer
Metadata
1 maintainer
Release files for mcp-atlassian 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_atlassian-0.1.1.tar.gz | 19.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_atlassian-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.0 kB
Release files / mcp_atlassian-0.1.1.tar.gz
| Download URL | mcp_atlassian-0.1.1.tar.gz |
|---|---|
| Size | 19.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
998a152cdcb32e77b404d274800a07b60dbf204c5a56aa736621df8a109a7b0c
|
|
BLAKE2b-256 checksum How to use checksums |
8056cc8fa590e1eef40df118c5b0111436a6b2533f56c400c40a2e18b63011b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.5
|
Release files / mcp_atlassian-0.1.1-py3-none-any.whl
| Download URL | mcp_atlassian-0.1.1-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61889320fe69577690a5276b9c4f58a6af3296433a6420bbc5f60941f16c2b1e
|
|
BLAKE2b-256 checksum How to use checksums |
5f45822bedbe854496ebb422f6f641f643c433a9feaf28e7d7e0f9b60eebe5ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.5
|
