Linear

The Linear enables tools and to call Linear APIs on behalf of a .

Want to quickly get started with Linear in your or AI app? The pre-built Arcade Linear MCP Server is what you want!

What’s documented here

This page describes how to use and configure Linear auth with Arcade.

This is used by:

The Arcade Linear MCP Server, which provides pre-built for interacting with Linear
Your app code that needs to call Linear APIs
Or, your custom tools that need to call Linear APIs

Configuring Linear auth

When using your own app credentials, make sure you configure your to use a custom user verifier. Without this, your end-users will not be able to use your app or in production.

In a production environment, you will most likely want to use your own Linear app credentials. This way, your will see your application’s name requesting permission.

Before showing how to configure your Linear app credentials, let’s go through the steps to create a Linear app.

Create a Linear app

It is highly recommended to first create a new Linear workspace for the purpose of managing the OAuth2 Application, as each admin will have access
Create a new public OAuth2 Application in your integration settings page
Fill out your application specific information such as application name and description
Choose the scopes (permissions) you need for your app
Add the redirect URL generated by Arcade (see below) to the Callback URL field
Toggle the Public switch if you want other workspaces to be able to use your application
Copy the client ID and client secret to use below

Next, add the Linear app to Arcade.

Configuring your own Linear Auth Provider in Arcade

Dashboard GUI

Configure Linear Auth Using the Arcade Dashboard GUI

Access the Arcade Dashboard

To access the Arcade Cloud dashboard, go to api.arcade.dev/dashboard . If you are self-hosting, by default the dashboard will be available at http://localhost:9099/dashboard . Adjust the host and port number to match your environment.

Navigate to the OAuth Providers page

Under the Connections section of the Arcade Dashboard left-side menu, click Connected Apps.
Click Add OAuth Provider in the top right corner.
Select the Included Providers tab at the top.
In the Provider dropdown, select Linear.

Enter the provider details

Choose a unique ID for your provider (e.g. “my-linear-provider”).
Optionally enter a Description.
Enter the Client ID and Client Secret from your Linear app.
Note the Redirect URL generated by Arcade. This must be added to your Linear app’s Callback URL field.

Create the provider

Hit the Create button and the provider will be ready to be used.

When you use tools that require Linear auth using your Arcade credentials, Arcade will automatically use this Linear OAuth provider. If you have multiple Linear providers, see using multiple auth providers of the same type for more information.

Using Linear auth in app code

Use the Linear in your own and AI apps to get a token for Linear APIs. See authorizing agents with Arcade to understand how this works.

Use client.auth.start() to get a token for Linear APIs:

Python


from arcadepy import Arcade
import httpx
 
client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
 
user_id = "{arcade_user_id}"
 
"""
In this example, we will use Arcade to authenticate with Linear and
retrieve teams.
 
There is a tool for that in the Arcade Linear MCP Server, which simplifies
the process for you to interact with Linear either through our Python or
JavaScript SDKs or via LLM tool calling.
 
Below we are just showing how to use Arcade as an auth provider, if you ever
need to.
"""
 
# Start the authorization process
auth_response = client.auth.start(
    user_id=user_id,
    provider="linear",
    scopes=["read"],
)
 
if auth_response.status != "completed":
    print("Please complete the authorization challenge in your browser:")
    print(auth_response.url)
 
# Wait for the authorization to complete
auth_response = client.auth.wait_for_completion(auth_response)
 
token = auth_response.context.token
 
if not token:
    raise ValueError("No token found in auth response")
 
# Use the Linear GraphQL API
url = "https://api.linear.app/graphql"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json",
}
 
query = """
query Teams {
  teams {
    nodes {
      id
      name
      key
    }
  }
}
"""
 
response = httpx.post(url, json={"query": query}, headers=headers)
data = response.json()
teams = data["data"]["teams"]["nodes"]
 
print(teams)

Using Linear auth in custom tools

You can use the pre-built Arcade Linear MCP Server to quickly build and AI apps that interact with Linear.

If the pre-built tools in the Linear Server don’t meet your needs, you can author your own custom tools that interact with the Linear API.

Use the Linear() auth class to specify that a requires authorization with Linear. The context.authorization.token field will be automatically populated with the ’s Linear token:

Python


from typing import Annotated, Any
 
from arcade_tdk import ToolContext, tool
from arcade_tdk.auth import Linear
 
import httpx
 
 
@tool(requires_auth=Linear(scopes=["read"]))
async def get_teams(
    context: ToolContext,
) -> Annotated[dict[str, Any], "Teams in the workspace with member information"]:
    """Get Linear teams and team information including team members"""
    if not context.authorization or not context.authorization.token:
        raise ValueError("No token found in context")
 
    token = context.authorization.token
    url = "https://api.linear.app/graphql"
    headers = {
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
    }
 
    query = """
    query Teams {
      teams {
        nodes {
          id
          name
          key
        }
      }
    }
    """
 
    async with httpx.AsyncClient() as client:
        resp = await client.post(url, json={"query": query}, headers=headers)
        resp.raise_for_status()
        data = resp.json()
        teams = data["data"]["teams"]["nodes"]
        return teams