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, verifies SHA-256 checksum, 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)
sha256
string
Required
Expected SHA-256 hex digest of the decoded file bytes.
size
integer
Optional
Optional expected decoded file size in bytes. Rejects the upload if it does not match.
subtitle
string
Optional
Optional subtitle for the attachment
title
string
Optional
Optional title for the attachment
linearmcp_create_initiative_label
Create initiative label
linearmcp_delete_attachment
Delete attachment
linearmcp_delete_customer
Delete customer
linearmcp_delete_status_update
Update delete status
linearmcp_extract_images
Extract images
linearmcp_get_agent_skill
Get agent skill
linearmcp_get_diff
Get diff
linearmcp_get_document
Get document
linearmcp_get_issue
Issue get
linearmcp_get_milestone
Get milestone
linearmcp_get_release
Get release
linearmcp_get_status_updates
Get status updates
linearmcp_get_user
Get user
linearmcp_list_agent_skills
List agent skills
linearmcp_list_customers
List customers
linearmcp_list_diffs
List diffs
linearmcp_list_initiatives
List initiatives
linearmcp_list_issue_statuses
List issue statuses
linearmcp_list_milestones
List milestones
linearmcp_list_release_notes
List release notes
linearmcp_list_releases
List releases
linearmcp_prepare_attachment_upload
Upload prepare attachment
linearmcp_resolve_diff_thread
Resolve diff thread
linearmcp_save_customer
Save customer
linearmcp_save_diff_comment
Save diff comment
linearmcp_save_initiative
Save initiative
linearmcp_save_milestone
Save milestone
linearmcp_save_release
Save release
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.

What other MCP connectors does Scalekit support?
Scalekit runs the Dart AI MCP server, Atlassian Rovo MCP server, and Monday MCP server on the same per-user auth, token vault, and audit trail. Browse 500+ connectors in the MCP connector directory.

How do I build a Linear agent?
Follow a step-by-step tutorial: Add Linear Tools to a Claude Agent in 50 Lines of Python; Build a Customer Escalation Agent: Intercom, Linear, Slack; DevOps AI agent assistant for GitHub, Linear, Slack. Each one covers per-user auth, tool scoping, and working agent code for Linear.

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