linear-mcp-go

WHAT IT CONNECTS

What linear-mcp-go gives an AI Agent

• Create, update, and search Linear issues
• Get issues assigned to a user
• Add comments to issues
• Retrieve team information
• Rate-limited API requests to respect Linear's API limits
• Go 1.23 or higher
• Linear API key
• Download the appropriate binary for your platform
• Make it executable (Linux/macOS):
• Run the binary as described in the Usage section
• Set your Linear API key as an environment variable:
• Run the server:
• Checks if the Linear MCP binary is already installed
• Copies the current binary to the installation directory if needed
• Configures the AI assistant to use the Linear MCP server
• Sets up auto-approval for specified tools if requested
• `--auto-approve=allow-read-only`: Auto-approves all read-only tools (`linear_search_issues`, `linear_get_user_issues`, `linear_get_issue`, `linear_get_teams`)
• `--auto-approve=tool1,tool2,...`: Auto-approves the specified comma-separated list of tools
• Cline (VSCode extension)
• `linear_create_issue`
• `linear_update_issue`
• `linear_add_comment`
• `title` (required): Issue title
• `team` (required): Team identifier (key, UUID or name)
• `description`: Issue description
• `priority`: Priority (0-4)
• `status`: Issue status
• `parentIssue`: Optional parent issue ID to create a sub-issue
• `labels`: Optional comma-separated list of label IDs to assign
• `id` (required): Issue ID
• `title`: New title
• `description`: New description
• `priority`: New priority (0-4)
• `status`: New status
• `query`: Optional text to search in title and description
• `teamId`: Filter by team ID
• `status`: Filter by status name (e.g., 'In Progress', 'Done')
• `assigneeId`: Filter by assignee's user ID
• `labels`: Filter by label names (comma-separated)
• `priority`: Filter by priority (1=urgent, 2=high, 3=normal, 4=low)
• `estimate`: Filter by estimate points
• `includeArchived`: Include archived issues in results (default: false)
• `limit`: Max results to return (default: 10)
• `userId`: Optional user ID. If not provided, returns authenticated user's issues
• `includeArchived`: Include archived issues in results
• `limit`: Maximum number of issues to return (default: 50)
• `issueId` (required): ID of the issue to retrieve
• `issueId` (required): ID of the issue to comment on
• `body` (required): Comment text in markdown format
• `createAsUser`: Optional custom username to show for the comment
• `displayIconUrl`: Optional avatar URL for the comment
• `name`: Optional team name filter. Returns teams whose names contain this string.
• All pushes to the main branch and pull requests are automatically tested
• When a tag matching the pattern `v*` (e.g., `v1.0.0`) is pushed, a new release is automatically created
• Binaries for Linux, macOS, and Windows are built and attached to the release
• Update the version in `pkg/server/server.go`
• Commit the changes
• Create and push a tag matching the version: