linear-mcp-fast 0.2.2__tar.gz → 0.2.4__tar.gz

{linear_mcp_fast-0.2.2 → linear_mcp_fast-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linear-mcp-fast
-Version: 0.2.2
+Version: 0.2.4
 Summary: Fast MCP server for Linear - reads from Linear.app's local cache on macOS
 Author: everything-chalna
 License-Expression: MIT
@@ -26,36 +26,45 @@ Requires-Dist: brotli>=1.0.0
 
 Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
 
-**Why?**
-- **Instant**: No API calls, reads directly from local IndexedDB cache
-- **Offline**: Works without internet
-- **Lower context**: Smaller responses for AI assistants
+## Why I Built This
 
-**Use with**: Official Linear MCP for write operations (comments, updates).
+While using the official Linear MCP with Claude Code, I noticed that **read operations consumed too much context**. Every issue query returned verbose responses with metadata I didn't need, eating into the AI's context window.
 
-## Installation
+The problem:
+- Official Linear MCP makes API calls for every read
+- Responses include excessive metadata (full user objects, workflow states, etc.)
+- Context window fills up quickly when exploring issues
+- Slower response times due to network latency
 
-```bash
-pip install linear-mcp-fast
-# or
-uv pip install linear-mcp-fast
-```
+My solution: **Read directly from Linear.app's local cache.**
+
+Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
+
+- **Zero API calls** - Instant reads from disk
+- **Smaller responses** - Only the fields you need
+- **Offline access** - Works without internet
+- **Faster iteration** - No rate limits, no latency
+
+## Requirements
+
+- **macOS only** - Linear.app stores its cache at `~/Library/Application Support/Linear/`
+- **Linear.app** installed and opened at least once (to populate the cache)
 
 ## Setup
 
+Use `linear-fast` for reads and the official Linear MCP for writes.
+
 ### Claude Code
 
 ```bash
-# 1. Add linear-mcp-fast (reads from local cache)
+# Fast reads (this package)
 claude mcp add linear-fast -- uvx linear-mcp-fast
 
-# 2. Add official Linear MCP (for writes)
+# Writes via official Linear MCP
 claude mcp add --transport http linear https://mcp.linear.app/mcp
 ```
 
-Now you have:
-- `linear-fast` → Fast reads from local cache
-- `linear` → Writes (comments, updates)
+Run `/mcp` to authenticate with Linear.
 
 ### Claude Desktop
 
@@ -76,7 +85,22 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-### Cursor / VS Code
+### Cursor
+
+Install Linear MCP from [Cursor's MCP tools page](https://cursor.com/mcp), then add linear-fast:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    }
+  }
+}
+```
+
+### VS Code / Windsurf / Others
 
 ```json
 {
@@ -93,24 +117,16 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
----
-
-## Prerequisites
-
-- **macOS** (Linear.app stores cache in `~/Library/Application Support/Linear/`)
-- **Linear.app** installed and opened at least once
-
----
+See [Linear MCP docs](https://developers.linear.app/docs/ai/mcp-server) for Zed, Codex, v0, and other clients.
 
 ## Available Tools
 
-### Reading (linear-fast)
+Tools mirror the official Linear MCP for easy switching:
 
 | Tool | Description |
 |------|-------------|
-| `list_issues` | List issues with filters (assignee, team, state, priority) |
-| `get_issue` | Get issue details with comments |
-| `list_my_issues` | List issues assigned to a user |
+| `list_issues` | List issues with filters (team, state, assignee, priority) |
+| `get_issue` | Get issue details by identifier (e.g., `UK-123`) |
 | `list_teams` | List all teams |
 | `get_team` | Get team details |
 | `list_projects` | List all projects |
@@ -119,44 +135,37 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 | `get_user` | Get user details |
 | `list_issue_statuses` | List workflow states for a team |
 
-### Writing (official Linear MCP)
+For writes (create issue, add comment, update status), use the official Linear MCP.
 
-Use the official Linear MCP (`linear`) for:
-- Creating/updating issues
-- Adding comments
-- Changing status
+## How It Works
 
----
+```
+Linear.app (Electron)
+    ↓ syncs data to local cache
+IndexedDB (LevelDB)
+~/Library/Application Support/Linear/IndexedDB/...
+    ↓ read by
+linear-mcp-fast
+    ↓
+Fast, offline access to issues, teams, users, projects
+```
 
 ## Troubleshooting
 
-### "Linear database not found"
+**"Linear database not found"**
 
-Linear.app needs to be installed and opened at least once:
+Linear.app must be installed and opened at least once:
 ```bash
 ls ~/Library/Application\ Support/Linear/IndexedDB/
 ```
 
-### Data seems stale
+**Data seems stale**
 
-Local cache is updated when Linear.app syncs. Open Linear.app to refresh.
+The local cache updates when Linear.app syncs. Open Linear.app to refresh.
 
----
-
-## How It Works
-
-```
-Linear.app (Electron)
-    ↓ syncs to
-IndexedDB (LevelDB format)
-~/Library/Application Support/Linear/IndexedDB/...
-    ↓ read by
-linear-mcp-fast
-    ↓ provides
-Fast read-only access to issues, users, teams, comments
-```
+**Returns 0 issues**
 
----
+Multiple IndexedDB databases may exist. Version 0.2.2+ automatically finds the correct one.
 
 ## License
 

linear_mcp_fast-0.2.4/README.md

@@ -0,0 +1,148 @@
+# linear-mcp-fast
+
+Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
+
+## Why I Built This
+
+While using the official Linear MCP with Claude Code, I noticed that **read operations consumed too much context**. Every issue query returned verbose responses with metadata I didn't need, eating into the AI's context window.
+
+The problem:
+- Official Linear MCP makes API calls for every read
+- Responses include excessive metadata (full user objects, workflow states, etc.)
+- Context window fills up quickly when exploring issues
+- Slower response times due to network latency
+
+My solution: **Read directly from Linear.app's local cache.**
+
+Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
+
+- **Zero API calls** - Instant reads from disk
+- **Smaller responses** - Only the fields you need
+- **Offline access** - Works without internet
+- **Faster iteration** - No rate limits, no latency
+
+## Requirements
+
+- **macOS only** - Linear.app stores its cache at `~/Library/Application Support/Linear/`
+- **Linear.app** installed and opened at least once (to populate the cache)
+
+## Setup
+
+Use `linear-fast` for reads and the official Linear MCP for writes.
+
+### Claude Code
+
+```bash
+# Fast reads (this package)
+claude mcp add linear-fast -- uvx linear-mcp-fast
+
+# Writes via official Linear MCP
+claude mcp add --transport http linear https://mcp.linear.app/mcp
+```
+
+Run `/mcp` to authenticate with Linear.
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Install Linear MCP from [Cursor's MCP tools page](https://cursor.com/mcp), then add linear-fast:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    }
+  }
+}
+```
+
+### VS Code / Windsurf / Others
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    },
+    "linear": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
+    }
+  }
+}
+```
+
+See [Linear MCP docs](https://developers.linear.app/docs/ai/mcp-server) for Zed, Codex, v0, and other clients.
+
+## Available Tools
+
+Tools mirror the official Linear MCP for easy switching:
+
+| Tool | Description |
+|------|-------------|
+| `list_issues` | List issues with filters (team, state, assignee, priority) |
+| `get_issue` | Get issue details by identifier (e.g., `UK-123`) |
+| `list_teams` | List all teams |
+| `get_team` | Get team details |
+| `list_projects` | List all projects |
+| `get_project` | Get project details |
+| `list_users` | List all users |
+| `get_user` | Get user details |
+| `list_issue_statuses` | List workflow states for a team |
+
+For writes (create issue, add comment, update status), use the official Linear MCP.
+
+## How It Works
+
+```
+Linear.app (Electron)
+    ↓ syncs data to local cache
+IndexedDB (LevelDB)
+~/Library/Application Support/Linear/IndexedDB/...
+    ↓ read by
+linear-mcp-fast
+    ↓
+Fast, offline access to issues, teams, users, projects
+```
+
+## Troubleshooting
+
+**"Linear database not found"**
+
+Linear.app must be installed and opened at least once:
+```bash
+ls ~/Library/Application\ Support/Linear/IndexedDB/
+```
+
+**Data seems stale**
+
+The local cache updates when Linear.app syncs. Open Linear.app to refresh.
+
+**Returns 0 issues**
+
+Multiple IndexedDB databases may exist. Version 0.2.2+ automatically finds the correct one.
+
+## License
+
+MIT

{linear_mcp_fast-0.2.2 → linear_mcp_fast-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linear-mcp-fast"
-version = "0.2.2"
+version = "0.2.4"
 description = "Fast MCP server for Linear - reads from Linear.app's local cache on macOS"
 readme = "README.md"
 license = "MIT"

{linear_mcp_fast-0.2.2 → linear_mcp_fast-0.2.4}/src/linear_mcp_fast.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linear-mcp-fast
-Version: 0.2.2
+Version: 0.2.4
 Summary: Fast MCP server for Linear - reads from Linear.app's local cache on macOS
 Author: everything-chalna
 License-Expression: MIT
@@ -26,36 +26,45 @@ Requires-Dist: brotli>=1.0.0
 
 Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
 
-**Why?**
-- **Instant**: No API calls, reads directly from local IndexedDB cache
-- **Offline**: Works without internet
-- **Lower context**: Smaller responses for AI assistants
+## Why I Built This
 
-**Use with**: Official Linear MCP for write operations (comments, updates).
+While using the official Linear MCP with Claude Code, I noticed that **read operations consumed too much context**. Every issue query returned verbose responses with metadata I didn't need, eating into the AI's context window.
 
-## Installation
+The problem:
+- Official Linear MCP makes API calls for every read
+- Responses include excessive metadata (full user objects, workflow states, etc.)
+- Context window fills up quickly when exploring issues
+- Slower response times due to network latency
 
-```bash
-pip install linear-mcp-fast
-# or
-uv pip install linear-mcp-fast
-```
+My solution: **Read directly from Linear.app's local cache.**
+
+Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
+
+- **Zero API calls** - Instant reads from disk
+- **Smaller responses** - Only the fields you need
+- **Offline access** - Works without internet
+- **Faster iteration** - No rate limits, no latency
+
+## Requirements
+
+- **macOS only** - Linear.app stores its cache at `~/Library/Application Support/Linear/`
+- **Linear.app** installed and opened at least once (to populate the cache)
 
 ## Setup
 
+Use `linear-fast` for reads and the official Linear MCP for writes.
+
 ### Claude Code
 
 ```bash
-# 1. Add linear-mcp-fast (reads from local cache)
+# Fast reads (this package)
 claude mcp add linear-fast -- uvx linear-mcp-fast
 
-# 2. Add official Linear MCP (for writes)
+# Writes via official Linear MCP
 claude mcp add --transport http linear https://mcp.linear.app/mcp
 ```
 
-Now you have:
-- `linear-fast` → Fast reads from local cache
-- `linear` → Writes (comments, updates)
+Run `/mcp` to authenticate with Linear.
 
 ### Claude Desktop
 
@@ -76,7 +85,22 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-### Cursor / VS Code
+### Cursor
+
+Install Linear MCP from [Cursor's MCP tools page](https://cursor.com/mcp), then add linear-fast:
+
+```json
+{
+  "mcpServers": {
+    "linear-fast": {
+      "command": "uvx",
+      "args": ["linear-mcp-fast"]
+    }
+  }
+}
+```
+
+### VS Code / Windsurf / Others
 
 ```json
 {
@@ -93,24 +117,16 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
----
-
-## Prerequisites
-
-- **macOS** (Linear.app stores cache in `~/Library/Application Support/Linear/`)
-- **Linear.app** installed and opened at least once
-
----
+See [Linear MCP docs](https://developers.linear.app/docs/ai/mcp-server) for Zed, Codex, v0, and other clients.
 
 ## Available Tools
 
-### Reading (linear-fast)
+Tools mirror the official Linear MCP for easy switching:
 
 | Tool | Description |
 |------|-------------|
-| `list_issues` | List issues with filters (assignee, team, state, priority) |
-| `get_issue` | Get issue details with comments |
-| `list_my_issues` | List issues assigned to a user |
+| `list_issues` | List issues with filters (team, state, assignee, priority) |
+| `get_issue` | Get issue details by identifier (e.g., `UK-123`) |
 | `list_teams` | List all teams |
 | `get_team` | Get team details |
 | `list_projects` | List all projects |
@@ -119,44 +135,37 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 | `get_user` | Get user details |
 | `list_issue_statuses` | List workflow states for a team |
 
-### Writing (official Linear MCP)
+For writes (create issue, add comment, update status), use the official Linear MCP.
 
-Use the official Linear MCP (`linear`) for:
-- Creating/updating issues
-- Adding comments
-- Changing status
+## How It Works
 
----
+```
+Linear.app (Electron)
+    ↓ syncs data to local cache
+IndexedDB (LevelDB)
+~/Library/Application Support/Linear/IndexedDB/...
+    ↓ read by
+linear-mcp-fast
+    ↓
+Fast, offline access to issues, teams, users, projects
+```
 
 ## Troubleshooting
 
-### "Linear database not found"
+**"Linear database not found"**
 
-Linear.app needs to be installed and opened at least once:
+Linear.app must be installed and opened at least once:
 ```bash
 ls ~/Library/Application\ Support/Linear/IndexedDB/
 ```
 
-### Data seems stale
+**Data seems stale**
 
-Local cache is updated when Linear.app syncs. Open Linear.app to refresh.
+The local cache updates when Linear.app syncs. Open Linear.app to refresh.
 
----
-
-## How It Works
-
-```
-Linear.app (Electron)
-    ↓ syncs to
-IndexedDB (LevelDB format)
-~/Library/Application Support/Linear/IndexedDB/...
-    ↓ read by
-linear-mcp-fast
-    ↓ provides
-Fast read-only access to issues, users, teams, comments
-```
+**Returns 0 issues**
 
----
+Multiple IndexedDB databases may exist. Version 0.2.2+ automatically finds the correct one.
 
 ## License
 

linear_mcp_fast-0.2.2/README.md

@@ -1,139 +0,0 @@
-# linear-mcp-fast
-
-Fast, read-only MCP server for Linear that reads from Linear.app's local cache on macOS.
-
-**Why?**
-- **Instant**: No API calls, reads directly from local IndexedDB cache
-- **Offline**: Works without internet
-- **Lower context**: Smaller responses for AI assistants
-
-**Use with**: Official Linear MCP for write operations (comments, updates).
-
-## Installation
-
-```bash
-pip install linear-mcp-fast
-# or
-uv pip install linear-mcp-fast
-```
-
-## Setup
-
-### Claude Code
-
-```bash
-# 1. Add linear-mcp-fast (reads from local cache)
-claude mcp add linear-fast -- uvx linear-mcp-fast
-
-# 2. Add official Linear MCP (for writes)
-claude mcp add --transport http linear https://mcp.linear.app/mcp
-```
-
-Now you have:
-- `linear-fast` → Fast reads from local cache
-- `linear` → Writes (comments, updates)
-
-### Claude Desktop
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "linear-fast": {
-      "command": "uvx",
-      "args": ["linear-mcp-fast"]
-    },
-    "linear": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
-    }
-  }
-}
-```
-
-### Cursor / VS Code
-
-```json
-{
-  "mcpServers": {
-    "linear-fast": {
-      "command": "uvx",
-      "args": ["linear-mcp-fast"]
-    },
-    "linear": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
-    }
-  }
-}
-```
-
----
-
-## Prerequisites
-
-- **macOS** (Linear.app stores cache in `~/Library/Application Support/Linear/`)
-- **Linear.app** installed and opened at least once
-
----
-
-## Available Tools
-
-### Reading (linear-fast)
-
-| Tool | Description |
-|------|-------------|
-| `list_issues` | List issues with filters (assignee, team, state, priority) |
-| `get_issue` | Get issue details with comments |
-| `list_my_issues` | List issues assigned to a user |
-| `list_teams` | List all teams |
-| `get_team` | Get team details |
-| `list_projects` | List all projects |
-| `get_project` | Get project details |
-| `list_users` | List all users |
-| `get_user` | Get user details |
-| `list_issue_statuses` | List workflow states for a team |
-
-### Writing (official Linear MCP)
-
-Use the official Linear MCP (`linear`) for:
-- Creating/updating issues
-- Adding comments
-- Changing status
-
----
-
-## Troubleshooting
-
-### "Linear database not found"
-
-Linear.app needs to be installed and opened at least once:
-```bash
-ls ~/Library/Application\ Support/Linear/IndexedDB/
-```
-
-### Data seems stale
-
-Local cache is updated when Linear.app syncs. Open Linear.app to refresh.
-
----
-
-## How It Works
-
-```
-Linear.app (Electron)
-    ↓ syncs to
-IndexedDB (LevelDB format)
-~/Library/Application Support/Linear/IndexedDB/...
-    ↓ read by
-linear-mcp-fast
-    ↓ provides
-Fast read-only access to issues, users, teams, comments
-```
-
----
-
-## License
-
-MIT