timescale/tiger-linear-mcp-server

Tiger Linear MCP Server

A wrapper around the Linear API to provide some focused tools to LLMs via the Model Context Protocol.

Development

Cloning and running the server locally.

git clone git@github.com:timescale/tiger-linear-mcp-server.git

Building

Run npm i to install dependencies and build the project. Use npm run watch to rebuild on changes.

Create a .env file based on the .env.sample file.

cp .env.sample .env

Testing

The MCP Inspector is a very handy to exercise the MCP server from a web-based UI.

npx @modelcontextprotocol/inspector

Testing in Claude Desktop

Create/edit the file ~/Library/Application Support/Claude/claude_desktop_config.json to add an entry like the following, making sure to use the absolute path to your local tiger-linear-mcp-server project, and use a valid api token.

{
  "mcpServers": {
    "tiger-linear": {
      "command": "node",
      "args": [
        "/absolute/path/to/tiger-linear-mcp-server/dist/index.js",
        "stdio"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_..."
      }
    }
  }
}