Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/tools-atlassian.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 10 additions & 0 deletions docs/tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,6 +143,16 @@ Check out the following pre-built tools that you can use with ADK agents:

<div class="tool-card-grid">

<a href="/adk-docs/tools/third-party/atlassian/" class="tool-card">
<div class="tool-card-image-wrapper">
<img src="../assets/tools-atlassian.png" alt="Atlassian">
</div>
<div class="tool-card-content">
<h3>Atlassian</h3>
<p>Manage issues, search pages, and update team content</p>
</div>
</a>

<a href="/adk-docs/tools/third-party/agentql/" class="tool-card">
<div class="tool-card-image-wrapper">
<img src="../assets/tools-agentql.png" alt="AgentQL">
Expand Down
101 changes: 101 additions & 0 deletions docs/tools/third-party/atlassian.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
# Atlassian

The [Atlassian MCP Server](https://github.com/atlassian/atlassian-mcp-server)
connects your ADK agent to the [Atlassian](https://www.atlassian.com/)
ecosystem, bridging the gap between project tracking in Jira and knowledge
management in Confluence. This integration gives your agent the ability to
manage issues, search and update documentation pages, and streamline
collaboration workflows using natural language.

## Use cases

- **Unified Knowledge Search**: Search across both Jira issues and Confluence
pages simultaneously to find project specs, decisions, or historical context.

- **Automate Issue Management**: Create, edit, and transition Jira issues, or
add comments to existing tickets.

- **Documentation Assistant**: Retrieve page content, generate drafts, or add
inline comments to Confluence documents directly from your agent.

## Prerequisites

- Sign up for an [Atlassian account](https://id.atlassian.com/signup)
- An Atlassian Cloud site with Jira and/or Confluence

## Use with agent

=== "Local MCP Server"

```python
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters


root_agent = Agent(
model="gemini-2.5-pro",
name="atlassian_agent",
instruction="Help users work with data in Atlassian products",
tools=[
McpToolset(
connection_params=StdioConnectionParams(
server_params=StdioServerParameters(
command="npx",
args=[
"-y",
"mcp-remote",
"https://mcp.atlassian.com/v1/sse",
]
),
timeout=30,
),
)
],
)
```

!!! note

When you run this agent for the first time, a browser window opens
automatically to request access via OAuth. Alternatively, you can use the
authorization URL printed in the console. You must approve this request to
allow the agent to access your Atlassian data.

## Available tools

Tool | Description
---- | -----------
`atlassianUserInfo` | Get information about the user
`getAccessibleAtlassianResources` | Get information about accessible Atlassian resources
`getJiraIssue` | Get information about a Jira issue
`editJiraIssue` | Edit a Jira issue
`createJiraIssue` | Create a new Jira issue
`getTransitionsForJiraIssue` | Get transitions for a Jira issue
`transitionJiraIssue` | Transition a Jira issue
`lookupJiraAccountId` | Lookup a Jira account ID
`searchJiraIssuesUsingJql` | Search Jira issues using JQL
`addCommentToJiraIssue` | Add a comment to a Jira issue
`getJiraIssueRemoteIssueLinks` | Get remote issue links for a Jira issue
`getVisibleJiraProjects` | Get visible Jira projects
`getJiraProjectIssueTypesMetadata` | Get issue types metadata for a Jira project
`getJiraIssueTypeMetaWithFields` | Get issue type metadata with fields for a Jira issue
`getConfluenceSpaces` | Get information about Confluence spaces
`getConfluencePage` | Get information about a Confluence page
`getPagesInConfluenceSpace` | Get information about pages in a Confluence space
`getConfluencePageFooterComments` | Get information about footer comments in a Confluence page
`getConfluencePageInlineComments` | Get information about inline comments in a Confluence page
`getConfluencePageDescendants` | Get information about descendants of a Confluence page
`createConfluencePage` | Create a new Confluence page
`updateConfluencePage` | Update an existing Confluence page
`createConfluenceFooterComment` | Create a footer comment in a Confluence page
`createConfluenceInlineComment` | Create an inline comment in a Confluence page
`searchConfluenceUsingCql` | Search Confluence using CQL
`search` | Search for information
`fetch` | Fetch information

## Additional resources

- [Atlassian MCP Server Repository](https://github.com/atlassian/atlassian-mcp-server)
- [Atlassian MCP Server Documentation](https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/)
10 changes: 10 additions & 0 deletions docs/tools/third-party/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,16 @@ Check out the following third-party tools that you can use with ADK agents:

<div class="tool-card-grid">

<a href="/adk-docs/tools/third-party/atlassian/" class="tool-card">
<div class="tool-card-image-wrapper">
<img src="../../assets/tools-atlassian.png" alt="Atlassian">
</div>
<div class="tool-card-content">
<h3>Atlassian</h3>
<p>Manage issues, search pages, and update team content</p>
</div>
</a>

<a href="/adk-docs/tools/third-party/agentql/" class="tool-card">
<div class="tool-card-image-wrapper">
<img src="../../assets/tools-agentql.png" alt="AgentQL">
Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -179,6 +179,7 @@ nav:
- Third-party tools:
- tools/third-party/index.md
- AgentQL: tools/third-party/agentql.md
- Atlassian: tools/third-party/atlassian.md
- Apify: tools/third-party/apify.md
- Bright Data: tools/third-party/bright-data.md
- Browserbase: tools/third-party/browserbase.md
Expand Down
Loading