> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monterey.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# External Integrations

> Analyzing data from GitHub, Jira, Linear and web sources

# External Integrations

Ask Monty can pull in data from external sources to give you a complete picture of your product and customer feedback, including development work, issue tracking, and public discourse.

## GitHub Integration

### What Can Monty Analyze?

* **GitHub Issues**: Bug reports, feature requests, discussions
* **Pull Requests**: Code changes, reviews, merge status

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/githubIssuesDataset.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=b3894034ae0580c2a078604c88333a16" alt="survey dataset" width="1674" height="876" data-path="images/monty/githubIssuesDataset.png" />

### Asking About GitHub

```
"Summarize GitHub issues from the past week"
"What pull requests were merged last month?"
"Show me open issues labeled 'bug'"
"List recent GitHub activity"
```

**Time range options:**

* Maximum lookback: 60 days
* Can specify: "last week", "past 30 days", "this month"

### GitHub Data Fields

For each issue/PR, Monty has access to:

* **Title and description**
* **State**: Open, closed, merged (for PRs)
* **Labels**: bug, enhancement, documentation, etc.
* **Dates**: Created, updated, closed
* **Key**: Issue/PR number
* **URL**: Link to the item
* **Assignees and authors** (when available)

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/githubIssuesDatasetExpanded.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=5d733f1a4f2d56e234780fd10a46e43f" alt="Github issues dataset" width="3050" height="1762" data-path="images/monty/githubIssuesDatasetExpanded.png" />

### Use Cases

GitHub integration excels at creating development summaries. Ask for an executive summary of the team's work over the past month, and Monty pulls all issues and PRs to summarize what's been completed, what's in progress, and what's planned. This is particularly useful for sprint retrospectives—"Summarize closed GitHub issues from the last 2 weeks"—giving you a quick view of completed work.

For bug tracking and feature planning, query open issues directly: "What bugs are currently open in GitHub?" or "Show me the most recent feature requests." These queries help with prioritization and roadmap planning, and you can export the results for further analysis.

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/githubIssuesResponse.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=911145b1b6ffeb76b5579d0b7ac92b91" alt="Github issues response text" width="1672" height="2816" data-path="images/monty/githubIssuesResponse.png" />

### Combining with Customer Feedback

Link customer feedback to development work:

```
"Compare customer bug reports to open GitHub issues"

→ Dataset 1: Customer-reported bugs
→ Dataset 2: Open GitHub bug issues
→ Analysis shows which customer issues have corresponding dev work
```

**Powerful for:**

* Prioritizing GitHub issues based on customer pain
* Checking if customer requests have tickets
* Reporting back to customers on fix status

## Jira Integration

### What Can Monty Analyze?

* **Jira Issues**: Stories, bugs, tasks, epics
* **Status tracking**: To-do, in progress, done
* **Sprint information**: Current and past sprint work

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/jiraIssuesDataset.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=0351892e391c20eb1490886ac874f1c0" alt="Jira issues dataset" width="1618" height="840" data-path="images/monty/jiraIssuesDataset.png" />

### Asking About Jira

```
"Summarize Jira tickets from the past month"
"What issues are currently in progress?"
"Show me completed work from this sprint"
"List open bugs in Jira"
```

**Time range options:**

* Maximum lookback: 60 days
* Can specify: "last week", "this sprint", "past 30 days"

### Jira Data Fields

For each issue, Monty has access to:

* **Summary and description**
* **Issue type**: Bug, story, task, epic
* **Status**: To-do, in progress, done, etc.
* **Priority**: High, medium, low
* **Dates**: Created, updated, completed
* **Key**: Issue ID (e.g., PROJ-123)
* **URL**: Link to the Jira ticket
* **Assignee and reporter**
* **Labels and components**

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/jiraIssuesDatasetExpanded.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=b6310d2bf326f066c62e5df0e7a94d04" alt="Jira issues dataset - expanded" width="2332" height="1750" data-path="images/monty/jiraIssuesDatasetExpanded.png" />

### Use Cases

**Team Status Reports:**

```
"What work has the team completed in the past 2 weeks?"

→ Pulls completed Jira issues
→ Perfect for status updates to leadership
```

**Sprint Summaries:**

```
"Summarize our current sprint work"

→ Shows in-progress and completed items
→ Great for daily standups or sprint reviews
```

**Bug Analysis:**

```
"How many critical bugs are open right now?"

→ Filters to high-priority bugs
→ Helps with triage and planning
```

**Roadmap Alignment:**

```
"What features are we building this quarter?"

→ Shows feature/story tickets
→ Aligns with product roadmap discussions
```

### Combining with Feedback

Connect development work to customer needs:

```
"Compare feature requests from customers to our Jira roadmap"

→ Dataset 1: Customer feature requests
→ Dataset 2: Jira feature tickets
→ Shows gaps and alignments
```

## Linear Integration

### What Can Monty Analyze?

* **Linear issues**: Stories, bugs, tasks, projects
* **Workflow states**: Team-specific states (backlog, in progress, done, custom)
* **Cycles**: Current and past cycles by team or number
* **Priority + labels**: Structured filters for urgency and tags
* **Teams & assignees**: Exact matches on team keys and user names

<img src="https://mintlify.s3.us-west-1.amazonaws.com/montereyai/images/monty/linearResponse.png" alt="Github issues response text" />

### Asking About Linear

```
"Show Linear issues for the Research team updated this week"
"Summarize high-priority Linear bugs that are labelled regression"
"Shoe me low-priority issues from the Research team that are in the Backlog"
"List Linear tickets labeled onboarding"
"What did we complete in Linear in cycle 1?"
```

**Time range options:**

* Maximum lookback: 60 days
* Date filters can target `createdAt` or `updatedAt` depending on whether you ask for new issues or recently updated work

### Linear Data Fields

For each Linear issue, Monty has access to:

* **Title and description**
* **Workflow state**: Team-aware state matching (e.g., "In Review", "Blocked")
* **Priority**: Mapped to your Linear priority scale
* **Labels**: Single or multiple labels mentioned in your question
* **Projects and teams**: Exact project name matches or combinations
* **Cycles**: Cycle name or number, including "current cycle" detection
* **Assignee information**
* **Dates**: Created and updated timestamps (60-day rolling window)
* **URLs and issue identifiers**

Monty translates natural language into Linear filters—matching teams, workflow states, labels, cycles, and priorities only when they exist in your workspace. Ambiguous references remain unfiltered to avoid incorrect assumptions, and “recently updated” questions automatically switch to the `updatedAt` field.

### Use Cases

**Team Health Checks:**

```
"Summarize Linear tickets for team Platform updated in the last 14 days"
→ Filters by team key and updatedAt
→ Perfect for weekly team reviews
```

**Cycle Reviews:**

```
"What work is in the current Linear cycle?"
→ Identifies the active cycle per team
→ Surfaces in-progress and completed issues
```

**Bug & Priority Triage:**

```
"Show high-priority Linear bugs assigned to Alex"
→ Matches assignee, priority label, and issue label
→ Ideal for daily standups
```

**Roadmap Tracking:**

```
"List Linear issues for Project Mercury that are blocked"
→ Combines project name with workflow state
→ Supports cross-functional reporting
```

### Combining with Feedback

```
"Compare customer bug reports to Linear issues labeled 'payments'"
→ Dataset 1: Customer bug feedback
→ Dataset 2: Linear bugs filtered by label and state
→ Highlights which customer-reported issues have tickets
```

Use Linear data alongside feedback to validate whether high-pain themes already have engineering coverage, identify gaps, and ensure Monty’s summaries cover both customer voice and delivery progress.

## Web Search

### What Can Monty Search?

Monty can search the web for:

* News articles about your product
* Public discussions and reviews
* Competitor information
* Industry trends
* Blog posts and social mentions

<img src="https://mintcdn.com/montereyai/hariULx8S2Znoypw/images/monty/webDataset.png?fit=max&auto=format&n=hariULx8S2Znoypw&q=85&s=dbead7ba0c282c5ab3637eb71582aaca" alt="Web search dataset - expanded" width="1642" height="818" data-path="images/monty/webDataset.png" />

### Asking About Web Content

```
"What has the news said about our recent product launch?"
"How is our product being discussed online?"
"Search the web for mentions of [feature]"
"What are people saying about [competitor] online?"
```

### Web Search Data

Results include:

* **Page titles**
* **Highlighted excerpts**: Most relevant passages
* **URLs**: Links to sources
* **Published dates**: When content was created
* **Relevance scores**: How well each result matches

<img src="https://mintcdn.com/montereyai/hariULx8S2Znoypw/images/monty/webSearch.png?fit=max&auto=format&n=hariULx8S2Znoypw&q=85&s=89400db62ffb157229afc1b0093412a7" alt="web-search-results" width="2068" height="1370" data-path="images/monty/webSearch.png" />

### Use Cases

**Launch Monitoring:**

```
"Search the web for news about our [product] launch"

→ Finds recent coverage
→ Shows public reception
```

**Competitive Intelligence:**

```
"What are people saying about [competitor]'s new feature?"

→ Gathers competitive insights
→ Informs strategy
```

**Sentiment Check:**

```
"How is [our feature] being received online?"

→ Shows public discourse
→ Complements internal feedback
```

**Industry Research:**

```
"What are the latest trends in [industry]?"

→ Finds thought leadership and news
→ Provides market context
```

**Validation:**

```
"Compare our customer feedback about [issue] to what's
being said online"

→ Dataset 1: Internal customer feedback
→ Dataset 2: Web search results
→ Shows if internal feedback aligns with public perception
```

<img src="https://mintcdn.com/montereyai/iKseqoce80g8thcY/images/monty/internalVsWebFeedback.png?fit=max&auto=format&n=iKseqoce80g8thcY&q=85&s=b23012bb8b29b508906afedc77b97b4d" alt="Web search dataset - expanded" width="1692" height="1976" data-path="images/monty/internalVsWebFeedback.png" />

## External Data Limitations

### Time Ranges

* **GitHub**: Maximum 60 days of history
* **Jira**: Maximum 60 days of history
* **Linear**: Maximum 60 days of history
* **Web search**: Recent results prioritized
* **Feedback**: No time limits

If you request longer ranges, Monty will use the maximum available and inform you.

### Data Freshness

External data is fetched in real-time when you ask, but:

* Recent activity may take minutes to appear
* Historical data depends on integration setup date
* Web search shows indexed content (may lag by hours/days)

### Access Requirements

External integrations must be connected and authorized:

* **GitHub**: Repository access configured
* **Jira**: Project access configured
* **Web search**: No special setup needed

If an integration isn't available, Monty will let you know.

## Best Practices

External integrations work best when combined with internal customer feedback. Don't just ask "What GitHub issues are open?"—instead, compare open GitHub bugs to customer-reported bugs to see which customer pain points have engineering attention.

Use multi-source queries for comprehensive analysis: "Create a monthly product health report including customer feedback, development work, and public sentiment." This gives stakeholders a complete picture across all data sources.

Validate assumptions by connecting dots between sources. Ask "Is the payment issue customers are reporting in GitHub?" to check if customer pain has corresponding engineering work. Monitor launches holistically with queries like "Analyze the \[feature] launch including customer feedback, GitHub activity, and web mentions."

Keep time ranges reasonable—under 60 days for GitHub and Jira due to API limitations. Time-bound your analysis: "What happened in GitHub during the last sprint?" or "Show me web mentions from the past week."

***

**Next:** [Advanced Features →](./advanced-features)
