linear-mcp-fast 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

{linear_mcp_fast-0.2.2.dist-info → linear_mcp_fast-0.2.4.dist-info}/METADATA

@@ -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.dist-info → linear_mcp_fast-0.2.4.dist-info}/RECORD

@@ -32,8 +32,8 @@ tools_and_utilities/benchmark.py,sha256=fyD5U6yI7Y0TkyhYtvvaHyk9Y2jJe2yxYWoFPQWy
 tools_and_utilities/ccl_chrome_audit.py,sha256=irGyYJae0apZDZCn23jMKmY3tYQgWyZEL8vdUBcHLZk,24695
 tools_and_utilities/dump_indexeddb_details.py,sha256=ipNWLKPQoSNhCtPHKWvMWpKu8FhCnvc4Rciyx-90boI,2298
 tools_and_utilities/dump_leveldb.py,sha256=hj7QnOHG64KK2fKsZ9qQOVqUUmHUtxUZqPYl4EZJO9U,1882
-linear_mcp_fast-0.2.2.dist-info/METADATA,sha256=qXx8bKX05IuBwJQNjme1wB4aBhoJaioP5-SZAbGTHJY,3812
-linear_mcp_fast-0.2.2.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-linear_mcp_fast-0.2.2.dist-info/entry_points.txt,sha256=Aa98tAkWz_08mS_SRyfyx0k3PuMBQoMygT88HCKMyWk,57
-linear_mcp_fast-0.2.2.dist-info/top_level.txt,sha256=j-O2BoBpFBpGyTl2V1cp0ZjxZAQwpkweeNxG4BcQ7io,73
-linear_mcp_fast-0.2.2.dist-info/RECORD,,
+linear_mcp_fast-0.2.4.dist-info/METADATA,sha256=i4TxcIFR-TxaJu4nbflPJvR2DdS-433LalZ0eZsX-bo,4728
+linear_mcp_fast-0.2.4.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+linear_mcp_fast-0.2.4.dist-info/entry_points.txt,sha256=Aa98tAkWz_08mS_SRyfyx0k3PuMBQoMygT88HCKMyWk,57
+linear_mcp_fast-0.2.4.dist-info/top_level.txt,sha256=j-O2BoBpFBpGyTl2V1cp0ZjxZAQwpkweeNxG4BcQ7io,73
+linear_mcp_fast-0.2.4.dist-info/RECORD,,