How to Use the Linear MCP in Cursor

Q: How do I configure the Linear MCP Server in Cursor?

Add the server configuration to your project-scoped .cursor/mcp.json file. Once saved, enable Agent mode in the chat panel to let the editor access the MCP tools.

Q: Can Cursor automatically update a Linear issue status when I finish a feature?

Yes, you use the updateissue tool within the chat interface to modify the ticket state. The editor executes the change directly against the API.

Q: How does Cursor search for Linear issues when I ask it to find a bug?

The editor calls searchissues with your text query to scan your active board. It returns matches with titles, priorities, and assignees directly into the chat window.

Q: Can I check my current sprint goals from the editor?

Run the listcycles tool to view your team's active sprint progress and dates. This keeps your coding priorities aligned with the current milestone.

Write code in Cursor using live context pulled from your Linear issues, projects, and cycles.

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 Cursor

Create your Vinkius account to connect Linear to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate code using live issue specifications in Cursor

The `get_issue` tool pulls complete ticket descriptions and requirements straight into your active editing session. Your Cursor agent reads the exact bug report or feature spec to write matching code. Instead of copying text from a browser, you feed the raw ticket data to the editor. It's that simple—the agent uses `list_labels` to match your code changes with current workflow tags.

Create and track tickets during active coding sessions

The `create_issue` tool registers new bugs on your board the moment your tests fail in the terminal. You define the team ID, priority, and description without switching windows. To keep your team updated, `create_comment` posts terminal logs or code snippets directly to the ticket. Cursor handles these updates in the background, keeping your focus on the codebase.

Scan team backlogs to plan your next commit

The `list_issues` tool retrieves active tickets assigned to your team so you can choose your next task. You filter by team ID to see what needs attention before writing a single line of code. This MCP Server lets your editor query `list_teams` to find the correct project scope. You know exactly where your code fits in the broader release cycle.

Setup guide

Set up Linear MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Linear MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Linear transactions." If the MCP tools are loaded correctly, Cursor will call the Linear tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "linear-mcp": {
      "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 Cursor

Add the server configuration to your project-scoped `.cursor/mcp.json` file. Once saved, enable Agent mode in the chat panel to let the editor access the MCP tools.

Yes, you use the `update_issue` tool within the chat interface to modify the ticket state. The editor executes the change directly against the API.

The editor calls `search_issues` with your text query to scan your active board. It returns matches with titles, priorities, and assignees directly into the chat window.

Run the `list_cycles` tool to view your team's active sprint progress and dates. This keeps your coding priorities aligned with the current milestone.

Your API tokens and issue descriptions are stored locally within your Cursor configuration files. They are never sent to third-party tracking services, keeping your proprietary project data secure.

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