Frequently Asked Questions (FAQ) about Linear MCP Server

Q: What is the Linear MCP Server?

A: The Linear MCP Server is a Model Context Protocol (MCP) server implementation that provides access to Linear’s issue tracking system through a standardized interface, enabling AI agents to interact with Linear data.

Q: What is MCP?

A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs), allowing AI models to access external data sources and tools.

Q: What are the prerequisites for using the Linear MCP Server?

A: You need a Linear account with API access and the Bun runtime (v1.0.0 or higher) installed.

Q: How do I install the Linear MCP Server?

A: Clone the repository, install dependencies using bun install, build the project using bun run build, and then configure the MCP server by editing the appropriate configuration file for your operating system and application.

Q: Where can I find the configuration file?

A: The configuration file location depends on your operating system and application:

• macOS:
  • Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows:
  • Cline: %APPDATA%CodeUserglobalStoragesaoudrizwan.claude-devsettingscline_mcp_settings.json
  • Claude Desktop: %APPDATA%Claude Desktopclaude_desktop_config.json
• Linux:
  • Cline: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Claude Desktop: sadly doesn’t exist yet

Q: How do I configure the Linear API key?

A: Set the LINEAR_API_KEY environment variable with your Linear API token.

Q: What MCP tools are available?

A: Available tools include create_issue, update_issue, get_issue, search_issues, get_teams, delete_issue, create_comment, get_projects, get_project_updates, and create_project_update.

Q: What kind of filtering does the search_issues tool support?

A: The search_issues tool supports a wide range of comparators for string, number, and date fields, including eq, neq, in, nin, contains, startsWith, endsWith, lt, lte, gt, and gte.

Q: What is UBOS?

A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. It helps you orchestrate AI Agents, connect them with your enterprise data, and build custom AI Agents with your LLM model and Multi-Agent Systems.

Q: Where can I find more information about the available MCP tools?

A: See the USAGE.md file for detailed usage examples of all tools.