Linear

Connect Linear when customer conversations need to become product or engineering work. The Rippit agent can use the context it finds in your conversations to look up related Linear work, create new issues, and keep existing work up to date.

What the agent gets

Issues and projects, including search and detail lookup.
Comments and updates that provide context on current work.
Issue and project creation and updates, when you enable the relevant write tools.

The full list is in Tools below. Linear expands its hosted MCP server over time, and a connection picks up new tools when it reconnects, so Manage tools on the connection card is the authoritative list for your connection.

Setup

In Rippit, open Connections → MCP Servers, choose Linear, and select one of these identity options:

Linear API key

Create a personal API key under Linear → Settings → Account → Security & Access. Limit the key to the permissions and teams the agent needs, then paste it into Rippit. An API-key connection is organization-wide and acts as the Linear user who created the key. Use a dedicated Linear identity and a narrowly scoped key rather than a key with broad personal access.

Your Linear account

Choose OAuth to sign in to Linear and approve Rippit. There is no Linear OAuth application to configure first. An OAuth connection acts as the Linear user who authorized it and can reach the work that user can access.

Connection scope

Linear connections are available in agentic chat only to Rippit Full Admins. OAuth connections can be personal or organization-wide: a personal connection is available only in the Full Admin’s own chats, while an organization-wide connection is available in every Full Admin’s chats and to scheduled Agent Apps. Linear API-key connections are organization-wide. Every connection uses the Linear identity that authorized it or created its API key. Sharing the connection does not substitute each Rippit user’s individual Linear permissions, so connect an identity with access appropriate for everyone who can use it.

Write access

Rippit requests Linear read and write access during OAuth so you can enable write tools later without reconnecting. The connection still starts read-only: tools that create or update Linear work remain off until a Rippit Full Admin enables them under Manage tools. Use a read-only Linear API key if the connection should never write, even if someone later changes the Rippit tool selection.

Tools

Linear exposes the tools below. The read set is enabled by default; the write set stays off until a Rippit Full Admin enables it under Manage tools.

Read

Tool	What it does
`list_issues`	List issues in the workspace, with filters, including Triage Intelligence suggestions for issues in triage
`get_issue`	Read one issue by ID, including attachments and git branch name
`list_issue_statuses`	List the statuses available in a team
`get_issue_status`	Read one issue status by name or ID
`list_issue_labels`	List issue labels in the workspace or a team
`list_comments`	List comments on an issue, project, initiative, document, milestone, or status update
`list_projects`	List projects in the workspace
`get_project`	Read one project
`list_project_labels`	List project labels in the workspace
`list_milestones`	List the milestones in a project
`get_milestone`	Read one milestone by ID or name
`get_status_updates`	List or read project and initiative status updates
`list_cycles`	List a team’s cycles
`get_triage_responsibility`	Read who is on a team’s triage rotation now, what happens when an issue enters triage, and upcoming shifts
`list_teams`	List teams in the workspace
`get_team`	Read one team
`list_users`	List users in the workspace
`get_user`	Read one user
`get_workspace`	Read the connected workspace
`list_custom_views`	List the saved issue, project, and initiative views the user can see
`list_documents`	List documents in the workspace
`get_document`	Read one document by ID or slug
`list_templates`	List the issue, project, and document templates available to the user
`get_template`	Read one template, including what it pre-fills and its form fields
`list_releases`	List releases, filterable by pipeline, stage, version, and text
`get_release`	Read one release by ID or slug
`list_release_pipelines`	List release pipelines
`list_release_notes`	List release notes, filterable by pipeline or release
`get_release_note`	Read one set of release notes, including its markdown
`list_diffs`	List the Linear diffs (pull requests) visible to the user
`get_diff`	Read one diff by review URL, GitHub PR URL, identifier, or slug
`get_diff_threads`	Read the comment threads on a diff, plus the user’s drafts
`get_attachment`	Read an attachment’s content by ID
`extract_images`	Fetch the images embedded in issue, comment, or document markdown
`get_notifications`	Read a page of the user’s Linear inbox
`list_agent_skills`	List the Linear Agent skills available to the user
`get_agent_skill`	Read one Linear Agent skill, including its instructions
`search_documentation`	Search Linear’s own product documentation

Write

Tool	What it does
`save_issue`	Create an issue, or update one when an ID is given
`save_comment`	Create or update a comment on an issue, project, initiative, document, milestone, or status update
`delete_comment`	Delete a comment
`save_project`	Create or update a project
`save_milestone`	Create or update a milestone in a project
`save_status_update`	Create or update a project or initiative status update
`delete_status_update`	Archive a project or initiative status update
`save_document`	Create or update a document
`save_issue_label`	Create or update an issue label
`create_issue_label`	Create an issue label. Deprecated by Linear in favor of `save_issue_label`
`retire_issue_label`	Retire an issue label so it cannot be applied to new issues
`restore_issue_label`	Restore a retired issue label
`save_project_label`	Create or update a project label
`retire_project_label`	Retire a project label so it cannot be applied to new projects
`restore_project_label`	Restore a retired project label
`save_release`	Create or update a release
`save_release_note`	Create or update release notes
`share_issue`	Share an issue with a workspace user who cannot otherwise see it
`unshare_issue`	Remove a user’s shared access to an issue
`prepare_attachment_upload`	Prepare a direct file upload for an issue
`create_attachment_from_upload`	Attach an already-uploaded file to an issue
`create_attachment`	Upload a tiny file inline as an attachment. Deprecated by Linear in favor of the two tools above
`delete_attachment`	Delete an attachment
`save_diff_comment`	Create, reply to, or edit a comment or draft on a diff
`delete_diff_comment`	Delete a comment or draft on a diff
`resolve_diff_thread`	Resolve or reopen a comment thread on a diff
`submit_diff_review`	Approve a diff, request changes, or submit a review comment
`merge_diff`	Merge a diff or add it to the merge queue
`mark_notification`	Mark an inbox notification read or unread, or snooze it

Every write tool acts as the Linear identity behind the connection and is limited to what that identity can do in Linear.

Getting Started

Connecting your Data

Using Rippit

Connecting to your AI Agent

Use cases

Reference

What the agent gets

Setup

Linear API key

Your Linear account

Connection scope

Write access

Tools

Read

Write

​What the agent gets

​Setup

​Linear API key

​Your Linear account

​Connection scope

​Write access

​Tools

​Read

​Write

What the agent gets

Setup

Linear API key

Your Linear account

Connection scope

Write access

Tools

Read

Write