Linear MCP

Live

OAUTH 2.0

PROJECT MANAGEMENT

Project Management

Connect to Linear's hosted MCP server to manage issues, projects, cycles, and comments directly from your AI workflows.

  • Acts as the user: Every tool call runs as the authorizing user. Access and audit trail stay intact.
  • Credentials stay vaulted: AES-256 encrypted, resolved at request time, never stored in LLM context.
  • Scoped before every call: Per-user permissions enforced automatically. 90-day audit trail included.
Linear MCP
agent · Acme Q3
Run
Create Attachment in Linear MCP
S
linearmcp_create_attachment
85ms
Linear MCP agent
Deprecated fallback for tiny files only. accepts base64 file content and uploads it through the mcp worker. prefer prepa.
Sources: Linear MCP
linearmcpmcp
1 tool call
18:29
Message Claude...

Tools your agent reaches for on Linear, scoped per user.

CALL ANY TOOL
Issues, projects, cycles, comments, and attachments: full Linear workflow, attributed to the real user.
linearmcp_list_diffs
List diffs
List Linear diff pull requests visible to the authenticated user
Parameters
Name
Type
Required
Description
cursor
string
Optional
Next page cursor
limit
number
Optional
Max results (default 50, max 250)
orderBy
string
Optional
Sort: createdAt | updatedAt
owner
string
Optional
Filter returned diffs by repository owner
query
string
Optional
Broad search by title, branch, PR number, or bare slug
repo
string
Optional
Filter returned diffs by repository name
status
string
Optional
Filter returned diffs by pull request status
linearmcp_search_documentation
Search documentation
linearmcp_list_teams
List teams
linearmcp_get_diff
Get diff
linearmcp_list_users
List users
linearmcp_get_team
Get team
linearmcp_list_cycles
List cycles
linearmcp_get_user
Get user
linearmcp_list_issues
List issues
linearmcp_get_issue
Get issue
linearmcp_list_comments
List comments
linearmcp_get_project
Get project
linearmcp_list_projects
List projects
linearmcp_get_release
Get release
linearmcp_list_releases
List releases
linearmcp_get_document
Get document
linearmcp_list_customers
List customers
linearmcp_get_milestone
Get milestone
linearmcp_list_documents
List documents
linearmcp_get_workspace
Get workspace
linearmcp_list_milestones
List milestones
linearmcp_get_attachment
Get attachment
linearmcp_list_initiatives
List initiatives
linearmcp_get_initiative
Get initiative
linearmcp_list_agent_skills
List agent skills
linearmcp_get_agent_skill
Get agent skill
linearmcp_list_issue_labels
List issue labels
linearmcp_get_diff_threads
Get diff threads
linearmcp_list_release_notes
List release notes
linearmcp_get_issue_status
Get issue status
Build your Agent
Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.
Python · LlamaIndex
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="linearmcp")

mcp = MultiServerMCPClient({
"linearmcp": {
"url": "https://mcp.scalekit.com/linearmcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()
import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "linearmcp" });

const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/linearmcp
// Pass: Authorization: Bearer + token
import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "linearmcp" });

const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/linearmcp
// Pass: Authorization: Bearer + token
from google.adk.agents import LlmAgent
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="linearmcp")
# Connect to MCP at https://mcp.scalekit.com/linearmcp
# Pass: Authorization: Bearer + token
Try these prompts
Copy any prompt into your agent. Each maps directly to a Linear tool. Click to copy, paste into your agent, done.
Get started
Copy the prompt
Copied
Search Linear’s documentation to learn about features and usage?
Copy the prompt
Copied
Create or update a project/initiative status update?
Advanced
Copy the prompt
Copied
Create or update a Linear project?
Copy the prompt
Copied
Create or update a milestone in a Linear project?
SEE HOW AUTH WORKS
Your users connect once. Their Linear credentials stay vaulted, every call is scope-checked, and every action is logged.
1
Authorize
Your user connects
Linear MCP
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Linear MCP
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Linear MCP
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Linear MCP
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
See the same per-user auth pattern across other connectors.
Engineering Teams
Engineering standup agent
Pulls commits from GitHub and GitLab, tracks issue movement in Jira, and posts a per-engineer standup brief to Slack. Each engineer's activity is read on their own delegated OAuth.
Engineering Teams
DevOps assistant agent
Polls GitHub for failing checks and stale PRs, opens Linear issues for the ones that need work, and posts a daily digest to Slack. It acts as the engineer, not a shared service account.
Engineering Teams
Slack triage
Polls Slack for new messages, classifies bugs and support requests with a LangGraph router, files GitHub issues or Zendesk tickets, and confirms in the thread.
People Ops and HR teams
Performance review collector
Collects review feedback from Airtable and Google Forms scoped to each manager's direct reports, writes per-employee summaries to Notion, and DMs the manager a Slack digest.
Test other agents
See the same per-user auth pattern across other connectors.
ENGINEERING
Engineering standup agent
Pull commits from GitHub and GitLab, track Jira issue movement, and post a per-engineer standup brief to Slack.
ENGINEERING
DevOps assistant agent
Poll GitHub for failing checks and stale pull requests, open Linear issues for the ones that need work, and digest to Slack.
ENGINEERING
Slack triage agent
Classify new Slack messages as bugs or support requests, file the GitHub issue or Zendesk ticket, and reply in the thread.
PEOPLE OPS
Performance review collector agent
Collect review feedback from Airtable and Google Forms per manager, summarise each report in Notion, and DM the digest in Slack.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential.
// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
One connector today. Ten tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions

Does the agent access Linear as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the Linear OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in Linear?
Yes. Pass a tool name filter to listScopedTools so the project management agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Linear.

What happens when a user revokes Linear access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Do issue updates show as the user or a bot?
As the user. Issues, comments, and status updates attribute to the authorizing user in Linear's history, and team membership controls which projects and cycles the agent can touch.

Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""linearmcp"": {
""url"": ""https://mcp.scalekit.com/linearmcp"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.linearmcp]
url = ""https://mcp.scalekit.com/linearmcp""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""linearmcp"": {
""url"": ""https://mcp.scalekit.com/linearmcp"",
""type"": ""http""
}
}
}