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
Deprecated fallback for tiny files only. accepts base64 file
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
Link an already-uploaded linear asseturl to an existing issu
linearmcp_create_issue_label
Create a new linear issue label
linearmcp_delete_attachment
Delete an attachment by id
linearmcp_delete_comment
Delete a linear comment.
linearmcp_delete_status_update
Delete (archive) a project or initiative status update.
linearmcp_extract_images
Extract and fetch images from markdown content. use this to
linearmcp_get_attachment
Retrieve an attachment's content by id.
linearmcp_get_diff
Exact lookup for a linear diff. use with review urls, github
linearmcp_get_diff_threads
Exact lookup for diff threads. use with review urls, github
linearmcp_get_document
Retrieve a linear document by id or slug
linearmcp_get_issue
Retrieve detailed information about an issue by id, includin
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
Engineering standup agent
Aggregate GitHub and GitLab activity, link to Jira, and post a daily standup digest to Slack. No async updates.
ENGINEERING
Auto-release notes agent
Group merged GitHub PRs by feature, fix, or chore and publish release notes per tag. No manual changelog grooming.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
Other connector libraries treat auth as a demo afterthought. Scalekit starts with identity, scope enforcement, and audit. Connectors follow.
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""
}
}
}