linear-toon-mcp 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c8a4dfd15f2122d8742273f0a2b305d9f52f15b26173f177589348efcaceffb
-  data.tar.gz: 5f6f12e5bb56fe7c62cdabf552e110bd6b91dfabe0d0a6c241de074c5d1a02b3
+  metadata.gz: 0daf1704fb96cea3eec8dbd60cb0c51a0facdd3e2ede5c3575b4f312fdde23c6
+  data.tar.gz: 8f45de9bd2c1a409b506cd87cfa47479b4aeaf731b0f928d84882eb21aeed9fd
 SHA512:
-  metadata.gz: b163ae42837c5ae08eecf3b3897345f8c81312b7692a937ad0ef9586a42978155e2e1260fe7aeaa91d5fde1dddf29f0d0c5b8bad40658351dc925c017e4507ad
-  data.tar.gz: abd70a25debba62a651736fc0bfc018bda3171b3dc71070a2a4c17e5f2bd3476519def4f80dfb4c51853ad513ef9ecf898fc40aa3ad5630415144a9dd7e4e4a9
+  metadata.gz: 9a1609b91fc4d8a4dd5fa5f46b77fe3bd38cf48a022dd1de9f00432ac29ab55a7c55ada94b0acc9342dc50134890f272db9531a6e6fb7e7e7736f766ef4c58c1
+  data.tar.gz: 7b9adcc7084b17bb7167ff469679559a033f217bcb523591bd5a74cee79f51798aa9c5f22695937738f4175bab45691c59da8e16b341f182e53f4f68d74561cf

data/README.md

@@ -44,7 +44,7 @@ claude mcp add linear-toon -e LINEAR_API_KEY=lin_api_xxxxx -- linear-toon-mcp
 
 | Tool | Description |
 |------|-------------|
-| `get_issue` | Retrieve a Linear issue by ID or identifier (e.g., `LIN-123`). Returns issue details including title, description, state, assignee, labels, project, and attachments. |
+| `get_issue` | Retrieve a Linear issue by ID or identifier (e.g., `LIN-123`). Returns issue details including title, description, state, assignee, labels, project, attachments, and the parent and direct child issues (each with identifier, title, state, and url). |
 | `list_issues` | List issues with optional filters (team, assignee, state, label, priority, project, cycle) and cursor-based pagination. Supports name or UUID for most filters. |
 | `list_issue_statuses` | List available workflow states for a team. Returns status id, type (backlog/unstarted/started/completed/canceled), and name. Accepts team name or UUID. |
 | `list_teams` | List all teams in the workspace. Returns team id, name, and key. |
@@ -53,8 +53,8 @@ claude mcp add linear-toon -e LINEAR_API_KEY=lin_api_xxxxx -- linear-toon-mcp
 | `list_projects` | List projects, optionally scoped to a team. Returns project id, name, and state. |
 | `list_cycles` | List cycles for a team. Returns cycle id, name, number, startsAt, and endsAt. Requires team name or UUID. |
 | `get_project` | Retrieve a specific project by name, ID, or slug. Returns project details including state, priority, dates, progress, and lead. Optional includes for members, milestones, and resources. |
-| `create_issue` | Create a new Linear issue. Accepts human-friendly names for team, assignee, state, labels, project, cycle, and milestone (resolved to IDs automatically). Supports issue relations and link attachments. |
-| `update_issue` | Update an existing Linear issue by ID. Supports partial updates, null to remove fields, and relation replacement. |
+| `create_issue` | Create a new Linear issue. Accepts human-friendly names for team, assignee, state, labels, project, cycle, and milestone (resolved to IDs automatically; label names resolve against the target team or workspace-wide labels). Relation params (`blocks`, `relatedTo`, `duplicateOf`) and `parentId` accept either issue UUIDs or human identifiers (e.g., `LIN-123`). Supports issue relations and link attachments. |
+| `update_issue` | Update an existing Linear issue by ID. Supports partial updates, null to remove fields, and relation replacement. Relation params (`blocks`, `relatedTo`, `duplicateOf`) and `parentId` accept either issue UUIDs or human identifiers (e.g., `LIN-123`). Label names resolve against the issue's team or workspace-wide labels. |
 | `create_comment` | Create a comment on a Linear issue. Supports Markdown content and threaded replies via parentId. |
 | `list_comments` | List comments for a specific Linear issue in chronological order. Returns each comment's id, body, author, and timestamps. |
 

data/lib/linear_toon_mcp/resolvers.rb

@@ -92,21 +92,45 @@ module LinearToonMcp
       data.dig("workflowStates", "nodes", 0, "id") or raise Error, "State not found: #{value}"
     end
 
+    # Resolve a single label name or UUID to its UUID.
+    # When +team_id+ is supplied, restricts the lookup to labels scoped to that
+    # team or to workspace-wide labels (where the label's team relation is null),
+    # so a name like "Bug" matches the right team-scoped label and not a same-named
+    # label on another team.
     # @param client [Client]
     # @param value [String] label UUID or name
+    # @param team_id [String, nil] optional team UUID to scope the lookup
     # @return [String] label UUID
     # @raise [Error] when label not found
-    def resolve_label(client, value)
+    def resolve_label(client, value, team_id: nil)
       return value if value.match?(UUID_RE)
-      data = client.query(LABEL_QUERY, variables: {filter: {name: {eqIgnoreCase: value}}})
-      data.dig("issueLabels", "nodes", 0, "id") or raise Error, "Label not found: #{value}"
+
+      filter = {name: {eqIgnoreCase: value}}
+      if team_id
+        filter[:or] = [
+          {team: {null: true}},
+          {team: {id: {eq: team_id}}}
+        ]
+      end
+
+      data = client.query(LABEL_QUERY, variables: {filter:})
+      id = data.dig("issueLabels", "nodes", 0, "id")
+      return id if id
+
+      raise Error, label_not_found_message(value, team_id)
     end
 
     # @param client [Client]
     # @param values [Array<String>] label UUIDs or names
+    # @param team_id [String, nil] optional team UUID to scope the lookup
     # @return [Array<String>] label UUIDs
-    def resolve_labels(client, values)
-      values.map { |v| resolve_label(client, v) }
+    def resolve_labels(client, values, team_id: nil)
+      values.map { |v| resolve_label(client, v, team_id:) }
+    end
+
+    def label_not_found_message(value, team_id)
+      return "Label not found: #{value}" unless team_id
+      "Label not found on target team or workspace: #{value}"
     end
 
     # @param client [Client]

data/lib/linear_toon_mcp/tools/create_issue.rb

@@ -6,7 +6,10 @@ module LinearToonMcp
   module Tools
     # Create a new Linear issue with full parameter support.
     # Resolves human-friendly names to IDs for team, assignee, state, labels,
-    # project, cycle, and milestone. Supports post-mutation relations and links.
+    # project, cycle, and milestone. Relation params (blocks, relatedTo,
+    # duplicateOf) and parentId accept either issue UUIDs or human identifiers
+    # (e.g., LIN-123); both are passed through to Linear unchanged.
+    # Supports post-mutation relations and links.
     class CreateIssue < MCP::Tool
       description "Create a new Linear issue"
 
@@ -30,10 +33,10 @@ module LinearToonMcp
           cycle: {type: "string", description: "Cycle name, number, or ID"},
           estimate: {type: "number", description: "Issue estimate value"},
           dueDate: {type: "string", description: "Due date (ISO format)"},
-          parentId: {type: "string", description: "Parent issue ID"},
-          blocks: {type: "array", items: {type: "string"}, description: "Issue IDs/identifiers this blocks"},
-          relatedTo: {type: "array", items: {type: "string"}, description: "Related issue IDs/identifiers"},
-          duplicateOf: {type: "string", description: "Duplicate of issue ID/identifier"},
+          parentId: {type: "string", description: "Parent issue UUID or identifier (e.g., LIN-123)"},
+          blocks: {type: "array", items: {type: "string"}, description: "Issue UUIDs or identifiers this blocks"},
+          relatedTo: {type: "array", items: {type: "string"}, description: "Related issue UUIDs or identifiers"},
+          duplicateOf: {type: "string", description: "Duplicate-of issue UUID or identifier"},
           milestone: {type: "string", description: "Milestone name or ID"},
           delegate: {type: "string", description: "Agent name or ID"},
           links: {type: "array", items: {type: "object", properties: {url: {type: "string"}, title: {type: "string"}}, required: ["url", "title"]}, description: "Link attachments [{url, title}]"}
@@ -88,7 +91,7 @@ module LinearToonMcp
           resolve_fields(input, client, team_id, **kwargs)
 
           data = client.query(MUTATION, variables: {input:})
-          result = data["issueCreate"]
+          result = data["issueCreate"] or raise Error, "Issue creation failed: no result returned"
           raise Error, "Issue creation failed" unless result["success"]
 
           issue = result["issue"]
@@ -131,7 +134,7 @@ module LinearToonMcp
           project: nil, cycle: nil, milestone: nil, delegate: nil, **)
           input[:assigneeId] = Resolvers.resolve_user(client, delegate || assignee) if assignee || delegate
           input[:stateId] = Resolvers.resolve_state(client, team_id, state) if state
-          input[:labelIds] = Resolvers.resolve_labels(client, labels) if labels
+          input[:labelIds] = Resolvers.resolve_labels(client, labels, team_id:) if labels
           project_id = Resolvers.resolve_project(client, project) if project
           input[:projectId] = project_id if project_id
           input[:cycleId] = Resolvers.resolve_cycle(client, team_id, cycle) if cycle

data/lib/linear_toon_mcp/tools/get_issue.rb

@@ -5,9 +5,10 @@ require "toon"
 module LinearToonMcp
   module Tools
     # Fetch a single Linear issue by ID or identifier and return it as TOON.
-    # Includes metadata, state, assignee, labels, project, team, and attachments.
+    # Includes metadata, state, assignee, labels, project, team, attachments,
+    # parent issue, and direct child issues.
     class GetIssue < MCP::Tool
-      description "Retrieve a Linear issue by ID"
+      description "Retrieve a Linear issue by ID, including its parent and direct child issues"
 
       annotations(
         read_only_hint: true,
@@ -46,6 +47,8 @@ module LinearToonMcp
             project { id name }
             team { id name }
             attachments { nodes { id title url } }
+            parent { identifier title url state { name } }
+            children(first: 50) { nodes { identifier title url state { name } } }
           }
         }
       GRAPHQL

data/lib/linear_toon_mcp/tools/update_issue.rb

@@ -5,7 +5,10 @@ require "toon"
 module LinearToonMcp
   module Tools
     # Update an existing Linear issue by ID. Supports partial updates,
-    # null to remove fields, and relation replacement semantics.
+    # null to remove fields, and relation replacement semantics. Relation
+    # params (blocks, relatedTo, duplicateOf) and parentId accept either
+    # issue UUIDs or human identifiers (e.g., LIN-123); both are passed
+    # through to Linear unchanged.
     class UpdateIssue < MCP::Tool
       description "Update an existing Linear issue"
 
@@ -30,10 +33,10 @@ module LinearToonMcp
           cycle: {type: "string", description: "Cycle name, number, or ID"},
           estimate: {type: "number", description: "Issue estimate value"},
           dueDate: {type: "string", description: "Due date (ISO format)"},
-          parentId: {type: ["string", "null"], description: "Parent issue ID. Null to remove"},
-          blocks: {type: "array", items: {type: "string"}, description: "Issue IDs this blocks. Replaces existing; omit to keep unchanged"},
-          relatedTo: {type: "array", items: {type: "string"}, description: "Related issue IDs. Replaces existing; omit to keep unchanged"},
-          duplicateOf: {type: ["string", "null"], description: "Duplicate of issue ID. Null to remove"},
+          parentId: {type: ["string", "null"], description: "Parent issue UUID or identifier (e.g., LIN-123). Null to remove"},
+          blocks: {type: "array", items: {type: "string"}, description: "Issue UUIDs or identifiers this blocks. Replaces existing; omit to keep unchanged"},
+          relatedTo: {type: "array", items: {type: "string"}, description: "Related issue UUIDs or identifiers. Replaces existing; omit to keep unchanged"},
+          duplicateOf: {type: ["string", "null"], description: "Duplicate-of issue UUID or identifier. Null to remove"},
           milestone: {type: "string", description: "Milestone name or ID"},
           delegate: {type: ["string", "null"], description: "Agent name or ID. Null to remove"},
           links: {type: "array", items: {type: "object", properties: {url: {type: "string"}, title: {type: "string"}}, required: ["url", "title"]}, description: "Link attachments [{url, title}]"}
@@ -111,7 +114,7 @@ module LinearToonMcp
           build_input(input, client, team_id, kwargs)
 
           data = client.query(MUTATION, variables: {id:, input:})
-          result = data["issueUpdate"]
+          result = data["issueUpdate"] or raise Error, "Issue update failed: no result returned"
           raise Error, "Issue update failed" unless result["success"]
 
           issue = result["issue"]
@@ -150,7 +153,7 @@ module LinearToonMcp
         end
 
         def needs_team_id?(kwargs)
-          kwargs.key?(:state) || kwargs.key?(:cycle)
+          kwargs.key?(:state) || kwargs.key?(:cycle) || kwargs.key?(:labels)
         end
 
         def build_input(input, client, team_id, kwargs)
@@ -179,7 +182,9 @@ module LinearToonMcp
         def add_resolved_fields(input, client, team_id, kwargs)
           input[:teamId] = team_id if kwargs.key?(:team) && team_id
           input[:stateId] = Resolvers.resolve_state(client, team_id, kwargs[:state]) if kwargs.key?(:state) && team_id
-          input[:labelIds] = Resolvers.resolve_labels(client, kwargs[:labels]) if kwargs.key?(:labels)
+          if kwargs.key?(:labels) && team_id
+            input[:labelIds] = Resolvers.resolve_labels(client, kwargs[:labels], team_id:)
+          end
           project_id = nil
           if kwargs.key?(:project) && kwargs[:project]
             project_id = Resolvers.resolve_project(client, kwargs[:project])

data/lib/linear_toon_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LinearToonMcp
-  VERSION = "0.6.0"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: linear-toon-mcp
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Yevhenii Hurin