Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Linear

Scalekit connector
Open markdown

The Linear connector lets your AI agent act in each user's Linear account. Each user signs in to Linear once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 62 tools.

Tools
62
What they doRead · write · destructive
27 · 24 · 1127 read24 write11 destructive
Users sign in with
OAuth app
Scalekit's or your own

What you can do

  • Read issues: fetch issues, projects, cycles, and team details
  • Create and update issues: file new issues, update status, set priority, and assign teammates
  • Manage projects: create and update project metadata and milestones
  • Search: find issues by keyword, assignee, label, or state

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Create the Linear connection

    In AgentKit > Connections, create a Linear connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Linear, so you don't need to register an OAuth app. To show your own app on the consent screen, use your own credentials instead.

    Use your own OAuth app

    Register your Scalekit environment with the Linear connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

    1. Set up auth redirects

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Linear and click Create. Copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

        Copy redirect URI from Scalekit dashboard

      • Log in to Linear and go to Settings → API → OAuth applications.

      • Click New application, enter an application name and description, then paste the redirect URI from Scalekit into the Callback URLs field. Click Create application.

        Create OAuth application in Linear

    2. Get client credentials

      • In your Linear OAuth application, copy the Client ID and Client Secret.

    3. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the connection you created.

      • Enter your credentials:

        Add credentials in Scalekit dashboard

      • Click Save.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'linear'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Linear:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'linear_attachments_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Getting resource IDs

Section titled “Getting resource IDs”

Most Linear tools require one or more IDs. Always fetch IDs from the API — never guess or hard-code them.

ResourceTool to get IDField in response
Team IDlinear_teams_listteams.nodes[].id
Issue IDlinear_issues_list or linear_issue_searchissues.nodes[].id
Project IDlinear_projects_listprojects.nodes[].id
Cycle IDlinear_cycles_listcycles.nodes[].id
Label IDlinear_labels_listissueLabels.nodes[].id
Workflow State IDlinear_workflow_states_listworkflowStates.nodes[].id
User IDlinear_users_listusers.nodes[].id
Comment IDlinear_comments_listcomments.nodes[].id
Attachment IDlinear_issue_get (include attachments)issue.attachments.nodes[].id
Webhook IDlinear_webhooks_listwebhooks.nodes[].id
Milestone IDlinear_project_milestones_listprojectMilestones.nodes[].id
Roadmap IDlinear_roadmaps_listroadmaps.nodes[].id

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • linear_attachment_getGet a single Linear attachment by ID using the attachment query, including its title, URL, source metadata, and timestamps.Read-only

    Get Attachment

    Get a single Linear attachment by ID using the attachment query, including its title, URL, source metadata, and timestamps.

    Inputs

    attachmentIdstringrequired
    ID of the attachment to retrieve
  • linear_attachments_listList attachments in the Linear workspace, optionally filtered by issue ID, with pagination support.Read-only

    List Attachments

    List attachments in the Linear workspace, optionally filtered by issue ID, with pagination support.

    Inputs

    afterstring
    Pagination cursor for fetching the next page
    firstinteger
    Number of attachments to return
    issueIdstring
    Filter attachments by issue ID
  • linear_comment_getGet one Linear comment by id.Read-only

    Get Comment

    Get one Linear comment by id. Returns the comment body and author. Use comment_get when you have the id. Use comments_list to find comments on an issue.

    Inputs

    commentIdstringrequired
    ID of the comment to retrieve
  • linear_comments_listList comments on one Linear issue with pagination.Read-only

    List Comments

    List comments on one Linear issue with pagination. Returns comment nodes with id, body, and author. Use comments_list to browse a thread. Use comment_get for one comment id.

    Inputs

    issueIdstringrequired
    ID of the issue to list comments for
    afterstring
    Pagination cursor for fetching the next page
    firstinteger
    Number of comments to return
  • linear_cycle_getGet a specific Linear cycle by ID, including its issues.Read-only

    Get Cycle

    Get a specific Linear cycle by ID, including its issues.

    Inputs

    cycleIdstringrequired
    ID of the cycle to retrieve
  • linear_cycle_issues_listList all issues in a specific Linear cycle with pagination support.Read-only

    List Cycle Issues

    List all issues in a specific Linear cycle with pagination support.

    Inputs

    cycleIdstringrequired
    ID of the cycle to list issues for
    afterstring
    Pagination cursor for fetching the next page
    firstinteger
    Number of issues to return
  • linear_cycles_listList cycles (sprints) for a Linear team with pagination support.Read-only

    List Cycles

    List cycles (sprints) for a Linear team with pagination support.

    Inputs

    teamIdstringrequired
    Team ID to list cycles for
    afterstring
    Pagination cursor for fetching the next page
    firstinteger
    Number of cycles to return
  • linear_issue_getGet one Linear issue by id, including state, assignee, team, labels, and project.Read-only

    Get Issue

    Get one Linear issue by id, including state, assignee, team, labels, and project. Returns the issue object. Use issue_get when you have the id. Use issues_list or issue_search to find an id.

    Inputs

    issueIdstringrequired
    ID of the issue to retrieve

Workflows

Proxy API call
// Make a GraphQL request via Scalekit proxy
const result = await actions.request({
  connectionName: 'linear',
  identifier: 'user_123',
  path: '/graphql',
  method: 'POST',
  body: JSON.stringify({ query: '{ viewer { id name email } }' }),
});
console.log(result);
Execute a tool
const result = await actions.executeTool({
  connector: 'linear',
  identifier: 'user_123',
  toolName: 'linear_graphql_query',
  toolInput: {
    query: '{ viewer { id name email } }',
  },
});
console.log(result);

Related: other Developer Tools connectors

All 117 in Developer Tools