Skip to content
TeamLoop

Linear Integration

Connect Linear to search issues, projects, and roadmaps across your workspace.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
IssuesTasks, bugs, features
ProjectsInitiatives, epics
CommentsDiscussion threads
CyclesSprint/iteration content
RoadmapsPlanning content

Connecting Linear

Section titled “Connecting Linear”
  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Linear
  4. Enter your Linear Personal API key

Creating a Linear API Key

Section titled “Creating a Linear API Key”
  1. Go to linear.app/settings/api
  2. Under Personal API keys, click Create key
  3. Give it a label (e.g., “TeamLoop”)
  4. Copy the key and paste it into TeamLoop

Your API key provides read access to all teams and issues you can access in Linear. We never modify your Linear workspace.

Example Queries

Section titled “Example Queries”

Search Issues

Section titled “Search Issues”
teamloop_query:
  query: "authentication bug"
  sources: "linear"

Find Project Context

Section titled “Find Project Context”
teamloop_query:
  query: "mobile app redesign"
  sources: "linear"

Search Roadmap Items

Section titled “Search Roadmap Items”
teamloop_query:
  query: "Q1 2025 roadmap priorities"
  sources: "linear"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks Linear issue changes:

Issue Timeline

Section titled “Issue Timeline”

When you query an issue, TeamLoop fetches its history:

  • Status changes (Backlog → In Progress → Done)
  • Priority changes
  • Assignee changes
  • Label changes
  • Estimate changes

Entity Extraction

Section titled “Entity Extraction”

Linear content maps to TeamLoop entity types:

Linear ContentTeamLoop Entity
IssueDOCUMENT
ProjectPROJECT
CommentDOCUMENT
Status changeCHANGE
AssigneePERSON

Temporal Queries with Linear

Section titled “Temporal Queries with Linear”

Point-in-Time

Section titled “Point-in-Time”

What was the project status on a date:

teamloop_query:
  query: "auth project"
  sources: "linear"
  mode: "as_of"
  as_of: "2024-06-01"

Sprint/Cycle History

Section titled “Sprint/Cycle History”

Track how a cycle progressed:

teamloop_evolution:
  query: "cycle:2024-W45"
  from_date: "2024-11-04"
  to_date: "2024-11-08"

Best Practices

Section titled “Best Practices”

1. Use Projects for Context

Section titled “1. Use Projects for Context”

Linear projects provide valuable context for queries.

2. Extract Decisions from Issues

Section titled “2. Extract Decisions from Issues”

Many Linear issues contain implicit decisions - extract them as DECISION entities.

3. Track Status Changes

Section titled “3. Track Status Changes”

Use temporal queries to understand work patterns and decision timelines.

Section titled “4. Link to GitHub”

Many Linear issues link to PRs. TeamLoop can track both sources together.

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify Linear integration is connected
  • Check team access permissions
  • Ensure issues aren’t in private teams
  • Try broader search terms

Missing Issues

Section titled “Missing Issues”
  • Check if issues are in teams you have access to
  • Verify your Linear role has access
  • If team membership changed, your existing API key should reflect new access automatically

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Accesses all teams your Linear account can see
  • You can revoke the key at linear.app/settings/api
  • TeamLoop never writes to Linear

Next Steps

Section titled “Next Steps”