Linear MCP Integration

Summary

The Linear MCP (Model Context Protocol) integration allows the Sokrates agent and Claude-based tools to interact directly with Linear project management data. It requires OAuth authentication and enables the agent to list, query, and manage issues within specific projects like “Wise Delivery” (Grimoire).

Details

The Linear MCP integration is a component of the Sokrates agent’s capability set, enabling a direct link between the conversational interface and the project’s issue tracking system. The integration utilizes the official Linear MCP server hosted at https://mcp.linear.app/mcp.

Authentication and Configuration

To function, the Linear MCP server requires OAuth-based authentication to access private workspace data. Within the Claude Code or terminal-based agent sessions, authentication is triggered using the command:

! claude mcp login linear

This command initiates the OAuth flow, allowing the agent to act on behalf of the user within the Linear workspace. Once authenticated, the agent gains access to a suite of tools, most notably mcp__plugin_linear_linear__list_issues, which allows for the retrieval of issue lists filtered by project or state.

Project Context: Wise Delivery (Grimoire)

The integration has been specifically utilized to manage tasks associated with “Wise Delivery,” a project also identified by the internal name “Grimoire.” The agent is capable of pulling issue descriptions, statuses, and metadata directly into the session context to inform development tasks or provide status updates. This capability bridges the gap between the technical implementation (handled by the agent) and the project management layer (handled in Linear), ensuring that the agent remains aware of the current sprint goals and outstanding bugs.