# jerhadf/linear-mcp-server architecture

> Architecture diagram of the GitHub repository jerhadf/linear-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jerhadf/linear-mcp-server
- Repository: https://github.com/jerhadf/linear-mcp-server

## Overview

This deprecated server exposes Linear issue-tracking operations to an MCP client over stdio. An LLM client invokes tools or requests resources; the server dispatches those requests to a Linear API client and returns results. The README documents issue creation, updates, search, comments, team/user queries, and organization context. The implementation is concentrated in index.ts; excerpts show startup, rate limiting, and some resource dispatch, but not every tool handler, so documented but unsampled operation links cite the README.

Main entry points: [`index.ts`](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts) (Linear client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["MCP interface"]
  node_mcp["MCP server<br/>[index.ts]"]
  node_tool_dispatch["Tool dispatch<br/>[index.ts]"]
  node_resource_dispatch["Resource dispatch<br/>[index.ts]"]
end

subgraph group_operations["Issue operations"]
  node_linear_client["Linear client<br/>[index.ts]"]
  node_rate_limiter["Rate limiter<br/>[index.ts]"]
  node_issue_mutations["Issue mutations<br/>[index.ts]"]
  node_issue_search["Issue search<br/>[index.ts]"]
  node_comments["Issue comments<br/>[index.ts]"]
end

subgraph group_context["Linear context"]
  node_assigned_issues["Assigned issues<br/>[index.ts]"]
  node_team_issues["Team issues<br/>[index.ts]"]
  node_organization_context["Organization context<br/>[index.ts]"]
end

node_llm(("LLM client"))
node_linear_api["Linear API"]

node_llm -->|"sends requests"| node_mcp
node_mcp -->|"dispatches tools"| node_tool_dispatch
node_mcp -->|"routes resources"| node_resource_dispatch
node_tool_dispatch -->|"invokes"| node_issue_mutations
node_tool_dispatch -->|"invokes"| node_issue_search
node_tool_dispatch -->|"invokes"| node_comments
node_tool_dispatch -->|"invokes"| node_assigned_issues
node_resource_dispatch -->|"requests"| node_assigned_issues
node_resource_dispatch -->|"requests"| node_team_issues
node_resource_dispatch -->|"requests"| node_organization_context
node_resource_dispatch -->|"requests data"| node_linear_client
node_issue_mutations -.->|"uses"| node_linear_client
node_issue_search -.->|"uses"| node_linear_client
node_comments -.->|"uses"| node_linear_client
node_assigned_issues -.->|"uses"| node_linear_client
node_team_issues -.->|"uses"| node_linear_client
node_organization_context -.->|"uses"| node_linear_client
node_linear_client -->|"queues requests"| node_rate_limiter
node_linear_client -.->|"queries"| node_linear_api

click node_mcp "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_tool_dispatch "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_resource_dispatch "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_linear_client "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_rate_limiter "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_issue_mutations "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_issue_search "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_comments "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_assigned_issues "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_team_issues "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"
click node_organization_context "https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_tool_dispatch,node_resource_dispatch,node_llm toneBlue
class node_linear_client,node_rate_limiter,node_issue_mutations,node_issue_search,node_comments toneAmber
class node_assigned_issues,node_team_issues,node_organization_context,node_linear_api toneMint
```

## Components

### MCP interface

- [MCP server](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Tool dispatch](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Resource dispatch](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`

### Issue operations

- [Linear client](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Rate limiter](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Issue mutations](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Issue search](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Issue comments](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`

### Linear context

- [Assigned issues](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Team issues](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`
- [Organization context](https://github.com/jerhadf/linear-mcp-server/blob/main/index.ts): `index.ts`

### Other components

- **LLM client**
- **Linear API**

## Connections

- LLM client → MCP server: sends requests (evidence: `README.md`)
- MCP server → Tool dispatch: dispatches tools (evidence: `index.ts`)
- MCP server → Resource dispatch: routes resources (evidence: `index.ts`)
- Tool dispatch → Issue mutations: invokes (evidence: `README.md`)
- Tool dispatch → Issue search: invokes (evidence: `README.md`)
- Tool dispatch → Issue comments: invokes (evidence: `README.md`)
- Tool dispatch → Assigned issues: invokes (evidence: `index.ts`)
- Resource dispatch → Assigned issues: requests (evidence: `index.ts`)
- Resource dispatch → Team issues: requests (evidence: `index.ts`)
- Resource dispatch → Organization context: requests (evidence: `index.ts`)
- Resource dispatch → Linear client: requests data (evidence: `index.ts`)
- Issue mutations → Linear client: uses (evidence: `index.ts`)
- Issue search → Linear client: uses (evidence: `index.ts`)
- Issue comments → Linear client: uses (evidence: `index.ts`)
- Assigned issues → Linear client: uses (evidence: `index.ts`)
- Team issues → Linear client: uses (evidence: `index.ts`)
- Organization context → Linear client: uses (evidence: `index.ts`)
- Linear client → Rate limiter: queues requests (evidence: `index.ts`)
- Linear client → Linear API: queries
