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_create_attachment
Create attachment
Deprecated fallback for tiny files only. Accepts base64 file content and uploads it through the MCP worker. Prefer prepare_attachment_upload plus direct PUT plus create_attachment_from_upload.
Parameters
Name
Type
Required
Description
base64Content
string
Required
Deprecated base64-encoded file content to upload
contentType
string
Required
MIME type for the upload (e.g., 'image/png', 'application/pdf')
filename
string
Required
Filename for the upload (e.g., 'screenshot.png')
issue
string
Required
Issue ID or identifier (e.g., LIN-123)
subtitle
string
Optional
Optional subtitle for the attachment
title
string
Optional
Optional title for the attachment
linearmcp_create_attachment_from_upload
Upload create attachment from
linearmcp_delete_attachment
Delete attachment
linearmcp_delete_comment
Delete comment
linearmcp_delete_status_update
Update delete status
linearmcp_extract_images
Extract images
linearmcp_get_attachment
Get attachment
linearmcp_get_diff
Get diff
linearmcp_get_diff_threads
Get diff threads
linearmcp_get_document
Get document
linearmcp_get_issue
Issue get
linearmcp_get_milestone
Get milestone
linearmcp_get_project
Get project
linearmcp_get_status_updates
Get status updates
linearmcp_get_team
Get team
linearmcp_list_comments
List comments
linearmcp_list_cycles
List cycles
linearmcp_list_documents
List documents
linearmcp_list_issue_labels
List issue labels
linearmcp_list_issues
List issues
linearmcp_list_milestones
List milestones
linearmcp_list_projects
List projects
linearmcp_list_teams
List teams
linearmcp_prepare_attachment_upload
Upload prepare attachment
linearmcp_save_comment
Save comment
linearmcp_save_document
Save document
linearmcp_save_issue
Issue save
linearmcp_save_milestone
Save milestone
linearmcp_save_status_update
Update save status
linearmcp_search_documentation
Search documentation

For more tools, view docs.

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""
}
}
}