How to Use the Linear MCP in Claude Code

Q: How can I search for Linear issues using Claude Code?

Run a command that invokes the searchissues tool. Claude Code will return the results directly to your terminal output.

Q: Does Claude Code support batch updates for Linear?

Yes, you can script multiple updateissue calls. Claude Code executes these sequentially as part of your defined pipeline.

Q: How do I list my Linear teams in Claude Code?

Execute the listteams command. It will output all available team IDs and prefixes so you can filter your subsequent queries.

Automate your engineering pipeline by connecting Claude Code to your Linear workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Linear MCP to Claude Code

Create your Vinkius account to connect Linear to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Linear with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Linear integration for Claude Code

Run automated workflows in your terminal by using `list_issues` to grab your backlog. Claude Code pipes this data directly into your CI/CD processes. It works without a GUI, making it perfect for cron jobs or scripted reporting. Use `list_cycles` to track sprint velocity and trigger notifications based on progress.

Terminal-based ticket management for Claude Code

Manage your entire queue from the command line. Use `create_issue` to log bugs during test failures or `update_issue` to close tickets after a successful deploy. This keeps your workflow strictly in the terminal. Claude Code uses your credentials to perform these actions securely without any manual intervention.

Project visibility for Claude Code

Query your organization structure with `list_teams` and `list_projects` to scope your automation. Claude Code identifies the right targets for your scripts. It ensures your pipelines are always hitting the correct board. By calling `get_viewer`, the tool verifies your access level before executing any batch updates.

Setup guide

Set up Linear MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see linear-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Linear transactions." It will automatically discover and invoke the available Linear tools.

Terminal

claude mcp add --transport http linear-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Linear MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "linear-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Linear. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Linear now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Linear MCP in Claude Code

Run a command that invokes the `search_issues` tool. Claude Code will return the results directly to your terminal output.

Yes, you can script multiple `update_issue` calls. Claude Code executes these sequentially as part of your defined pipeline.

It is designed for that exact purpose. You can trigger it from a shell script to sync your issue status with your deployment cycles.

Execute the `list_teams` command. It will output all available team IDs and prefixes so you can filter your subsequent queries.

Your API token is passed securely to the server. The connection only touches ticket metadata and issue content, never sensitive source code or credentials.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript