Linear integration

Linear integration.

Connect Linear to sync issues, comments, and cycles into your ContextStream workspace. Project tracking becomes searchable memory events.

Per-workspace integration

The Linear integration is configured per workspace. Each ContextStream workspace can connect to different Linear workspaces or teams. This allows teams to keep their contexts separate while sharing the same ContextStream organization.

What you get

Linear data, surfaced where you work.

Once connected, your Linear data enriches AI interactions across ContextStream. Here's how it adds value:

Automatic Context Enrichment

When you call context_smart or session_smart_search, relevant Linear issues, comments, and decisions are automatically included in AI responses. No extra tools needed — your existing prompts become smarter.

Example: Ask "What are the blockers for the auth migration?" and get context extracted from Linear issue discussions without calling any Linear-specific tool.

Extracted Knowledge

ContextStream automatically distills decisions, lessons, and insights from your Linear issue threads. These become searchable memory that persists across sessions.

Example: Use integration(provider="linear", action="knowledge") to see "We decided to deprecate the v1 API" extracted from ENG-142 discussion.

Cross-Team Search

Search across all your synced Linear teams by meaning, not just keywords. Find issues, comments, and decisions across engineering, product, and design teams in one query.

Example: Search for "rate limiting" and find related issues across multiple Linear teams.

Unified Memory

Linear events become memory events alongside your manual captures. Use memory(action="search", ...) or session(action="recall", ...) to find Linear context mixed with your other decisions and notes.

Example: "What do we know about the payment system?" returns your captured decisions AND relevant Linear issue discussions.

Example prompts

Try these in your AI editor.

Try these prompts in your AI editor to see Linear integration in action:

terminal · prompts

>"What open issues are assigned to me?"

>"Show Linear issues with high priority"

>"What's the status of ENG-42?"

>"What decisions were made about the database migration?"

>"Show me issues blocked in the current cycle"

>"Search Linear for 'onboarding flow' from the last 7 days"

>"Summarize Linear activity for the past 2 weeks"

Overview

Project tracking as memory.

The Linear integration brings your project tracking data into ContextStream, making issues, comments, and cycles searchable and available as context for your AI tools. Content is synced as memory events that can be retrieved via MCP tools or the search API.

Real-time webhooks

Issues, comments, and cycle updates are captured via webhooks as they're created or changed.

Semantic search

Find issues and comments by meaning, not just keywords. Search across all synced teams instantly.

Cycle analytics

Track cycle progress, issue velocity, and team activity trends at a glance.

Setup guide

Three steps to connect.

Connect your Linear account

01Go to your ContextStream workspace settings and navigate to Integrations.
02Click Connect on the Linear card to start the OAuth flow.
03Authorize ContextStream to access your Linear workspace. You will be prompted to grant read access to issues, comments, and cycles.
04Once connected, the Linear card will show "Connected" status.

Select teams to sync

01Click Configure on the connected Linear integration.
02Browse available teams from your Linear workspace.
03Select the teams you want to sync. All issues, comments, and cycles for those teams will be imported.
04Optionally, link Linear teams to specific ContextStream projects for organized context retrieval.

Initial sync & backfill

01After selecting teams, ContextStream will perform an initial sync to import issues, comments, and cycles. You can configure the backfill depth in the integration settings.
02Click Sync Now at any time to trigger an immediate sync of all configured teams.

What gets synced

Synced content types.

Content type	Details	Metadata captured
Issues	All issues from configured teams	Title, description, status, priority, assignee, labels
Comments	Issue comments and discussion threads	Content, author, parent issue reference
Cycles	Sprint cycles and their progress	Name, status, start date, end date

MCP tools (v0.4.x)

Query Linear through MCP.

Access Linear data through the consolidated integration tool available in Claude Code, Cursor, and other MCP-compatible editors.

Use integration(provider="linear", action="...") for Linear-specific queries.

integration(provider="linear", action="stats")

Get overview statistics: total issues, comments, cycles, team counts, and sync status.

integration(provider="linear", action="issues", team_id="...", status="...", priority="...", assignee="...")

List and filter issues by team, status, priority, and assignee. Returns issue details with labels and cycle info.

integration(provider="linear", action="search", query="...")

Search Linear issues and comments by content. Filter by team, status, priority, and timeframe (days param). Sort by relevance, recent, or priority.

integration(provider="linear", action="activity")

Get recent activity feed, optionally filtered by team, type (issue, comment, cycle), and timeframe (days param).

integration(provider="linear", action="knowledge")

Get decisions, lessons, and insights automatically extracted from Linear issue discussions. Filter by knowledge type (decision, lesson, fact, insight).

integration(provider="linear", action="summary")

Get a high-level summary of Linear activity with trends, key decisions, and notable changes. Customize timeframe with the days param and optionally scope by team.

integration(provider="linear", action="connected")

Check whether the Linear integration is connected and authorized for the current workspace.

integration(provider="all", action="team_search", query="...")Team

Search across Linear, GitHub, Slack, and other connected integrations in a single query. Results ranked by relevance across sources. Sort by relevance, recent, or engagement.

Dashboard

Linear dashboard.

Access detailed analytics and insights from the Linear dashboard in your workspace settings.

Overview stats

Total issues, comments, cycles, and teams synced at a glance.

Activity chart

Visualize issue creation, completion, and comment activity over time to spot trends.

Cycle progress

Track active cycle completion rates, scope changes, and burndown across teams.

Team stats

Per-team breakdown of issues, priorities, statuses, and cycle throughput.

Security & privacy

Built-in safeguards.

OAuth 2.0 authentication

ContextStream uses Linear's official OAuth flow. Your credentials are never stored — only encrypted access tokens.

Read-only scopes

We request only read-only scopes needed for syncing: read for issues, comments, and cycles. No write access is requested — ContextStream never modifies your Linear data.

Explicit team selection

You choose exactly which teams to sync. No teams are synced by default.

Revoke anytime

Disconnect the integration at any time from your workspace settings. This revokes access and stops all syncing.

Sync behavior

How sync works.

Real-time webhooks

New issues, comments, and cycle changes are captured via Linear webhooks as they're created. This provides near-instant sync for new content.

Periodic polling

A background sync runs periodically to catch any missed events and update issue statuses and priorities.

Manual sync

Click Sync Now in the integration settings to trigger an immediate full sync of all configured teams.

State updates

When issues change status, priority, or assignee, the state is updated in ContextStream automatically. Completed and cancelled issues are tracked alongside active work.

Troubleshooting

Common issues.

Integration shows "Error" status

This usually means the OAuth token has expired or been revoked. Try disconnecting and reconnecting the integration. If the issue persists, check that you haven't revoked the app authorization in your Linear Settings → Authorized Applications.

Teams not appearing after connection

Make sure you authorized access to the correct Linear workspace during the OAuth flow. If your organization has multiple workspaces, verify you selected the right one. You can disconnect and reconnect to choose a different workspace.

Search not finding recent issues

New content may take a few minutes to be indexed and searchable. Try clicking Sync Now to force an immediate sync, then search again.

Admin approval required

Some Linear workspaces require admin approval for OAuth integrations. Contact your Linear workspace admin to approve ContextStream access if you see an authorization error.

Next steps

Keep going.

Once connected, Linear issues, comments, and cycles become Memory Events (source: linear) and are available to your AI tools via MCP.

MCP documentation Memory system

Back to integrations overview or see GitHub integration.

Linear is a trademark of Linear Orbit, Inc. ContextStream is not affiliated with, endorsed by, or sponsored by Linear Orbit, Inc.