quickcall-integrations 0.3.7__py3-none-any.whl → 0.3.9__py3-none-any.whl

mcp_server/api_clients/github_client.py

@@ -582,8 +582,16 @@ class GitHubClient:
     # Issue Operations
     # ========================================================================
 
-    def _issue_to_dict(self, issue) -> Dict[str, Any]:
+    def _issue_to_dict(self, issue, summary: bool = False) -> Dict[str, Any]:
         """Convert PyGithub Issue to dict."""
+        if summary:
+            return {
+                "number": issue.number,
+                "title": issue.title,
+                "state": issue.state,
+                "labels": [label.name for label in issue.labels],
+                "html_url": issue.html_url,
+            }
         return {
             "number": issue.number,
             "title": issue.title,
@@ -595,6 +603,70 @@ class GitHubClient:
             "created_at": issue.created_at.isoformat(),
         }
 
+    def list_issues(
+        self,
+        owner: Optional[str] = None,
+        repo: Optional[str] = None,
+        state: str = "open",
+        labels: Optional[List[str]] = None,
+        assignee: Optional[str] = None,
+        creator: Optional[str] = None,
+        milestone: Optional[str] = None,
+        sort: str = "updated",
+        limit: int = 30,
+    ) -> List[Dict[str, Any]]:
+        """
+        List issues in a repository.
+
+        Args:
+            owner: Repository owner
+            repo: Repository name
+            state: Issue state: 'open', 'closed', or 'all'
+            labels: Filter by labels
+            assignee: Filter by assignee username
+            creator: Filter by issue creator username
+            milestone: Filter by milestone (number, title, or '*' for any, 'none' for no milestone)
+            sort: Sort by 'created', 'updated', or 'comments'
+            limit: Maximum issues to return
+
+        Returns:
+            List of issue summaries
+        """
+        gh_repo = self._get_repo(owner, repo)
+
+        kwargs = {"state": state, "sort": sort, "direction": "desc"}
+        if labels:
+            kwargs["labels"] = labels
+        if assignee:
+            kwargs["assignee"] = assignee
+        if creator:
+            kwargs["creator"] = creator
+        if milestone:
+            # Handle milestone - can be number, '*', 'none', or title
+            if milestone == "*" or milestone == "none":
+                kwargs["milestone"] = milestone
+            elif milestone.isdigit():
+                kwargs["milestone"] = gh_repo.get_milestone(int(milestone))
+            else:
+                # Search by title
+                for ms in gh_repo.get_milestones(state="all"):
+                    if ms.title.lower() == milestone.lower():
+                        kwargs["milestone"] = ms
+                        break
+
+        issues = []
+        count = 0
+        for issue in gh_repo.get_issues(**kwargs):
+            # Skip pull requests (GitHub API returns PRs in issues endpoint)
+            if issue.pull_request is not None:
+                continue
+            issues.append(self._issue_to_dict(issue, summary=True))
+            count += 1
+            if count >= limit:
+                break
+
+        return issues
+
     def create_issue(
         self,
         title: str,

mcp_server/tools/auth_tools.py

@@ -10,7 +10,7 @@ Also provides GitHub PAT authentication for users who can't install the GitHub A
 import os
 import logging
 import webbrowser
-from typing import Dict, Any
+from typing import Dict, Any, Optional
 
 import httpx
 from github import Github, Auth, GithubException
@@ -20,6 +20,7 @@ from pydantic import Field
 from mcp_server.auth import (
     get_credential_store,
     DeviceFlowAuth,
+    get_github_pat,
 )
 
 logger = logging.getLogger(__name__)
@@ -532,9 +533,10 @@ def create_auth_tools(mcp: FastMCP):
 
     @mcp.tool(tags={"auth", "github"})
     def connect_github_via_pat(
-        token: str = Field(
-            ...,
-            description="GitHub Personal Access Token (ghp_xxx or github_pat_xxx)",
+        token: Optional[str] = Field(
+            default=None,
+            description="GitHub Personal Access Token (ghp_xxx or github_pat_xxx). "
+            "If not provided, auto-detects from .quickcall.env or GITHUB_TOKEN env var.",
         ),
     ) -> Dict[str, Any]:
         """
@@ -543,17 +545,13 @@ def create_auth_tools(mcp: FastMCP):
         Use this if your organization can't install the QuickCall GitHub App.
         This is an alternative to the standard connect_github flow.
 
-        This command:
-        1. Validates your PAT by calling GitHub API
-        2. Auto-detects your GitHub username
-        3. Stores the PAT securely in ~/.quickcall/credentials.json
-
-        After connecting, you can use GitHub tools like list_repos, list_prs, etc.
+        Token auto-detection locations (in order):
+        1. GITHUB_TOKEN or GITHUB_PAT environment variable
+        2. .quickcall.env in your project root (where .git is)
+        3. ~/.quickcall.env in your home directory
 
         Create a PAT at: https://github.com/settings/tokens
-        Required scopes:
-        - repo (full access to private repos)
-        - OR public_repo (public repos only)
+        Required scopes (classic PAT): project, read:user, repo
 
         Note: PAT mode works independently of QuickCall. You don't need
         to run connect_quickcall first. However, Slack tools still require
@@ -571,11 +569,29 @@ def create_auth_tools(mcp: FastMCP):
                 "hint": "Use disconnect_github_pat to remove it, then connect again with a new token.",
             }
 
+        # Auto-detect token if not provided
+        token_source = "provided directly"
+        if not token:
+            token, token_source = get_github_pat()
+            if not token:
+                return {
+                    "status": "error",
+                    "message": "No token provided and none found automatically.",
+                    "searched_locations": [
+                        "GITHUB_TOKEN / GITHUB_PAT environment variables",
+                        ".quickcall.env in project root (where .git is located)",
+                        "~/.quickcall.env in home directory",
+                    ],
+                    "hint": "Either provide the token directly, set GITHUB_TOKEN env var, "
+                    "or create .quickcall.env with GITHUB_TOKEN=ghp_xxx",
+                }
+
         # Validate token format
         if not token.startswith(("ghp_", "github_pat_")):
             return {
                 "status": "error",
                 "message": "Invalid token format. GitHub PATs start with 'ghp_' or 'github_pat_'",
+                "token_source": token_source,
                 "hint": "Create a new token at https://github.com/settings/tokens",
             }
 
@@ -619,6 +635,7 @@ def create_auth_tools(mcp: FastMCP):
             "message": f"Successfully connected GitHub as {username}!",
             "username": username,
             "mode": "pat",
+            "token_source": token_source,
             "hint": "You can now use GitHub tools. Run check_github_connection to verify.",
         }
 

mcp_server/tools/github_tools.py

@@ -270,7 +270,7 @@ def _get_client() -> GitHubClient:
             "2. Run connect_quickcall to use QuickCall (GitHub App + Slack)\n"
             "3. Set GITHUB_TOKEN environment variable\n\n"
             "For PAT: Create token at https://github.com/settings/tokens\n"
-            "Required scopes: repo (private) or public_repo (public only)"
+            "Required scopes (classic PAT): project, read:user, repo"
         )
 
 
@@ -570,7 +570,7 @@ def create_github_tools(mcp: FastMCP) -> None:
     def manage_issues(
         action: str = Field(
             ...,
-            description="Action: 'view', 'create', 'update', 'close', 'reopen', 'comment', "
+            description="Action: 'list', 'view', 'create', 'update', 'close', 'reopen', 'comment', "
             "'add_sub_issue', 'remove_sub_issue', 'list_sub_issues'",
         ),
         issue_numbers: Optional[List[int]] = Field(
@@ -610,13 +610,35 @@ def create_github_tools(mcp: FastMCP) -> None:
             default=None,
             description="Repository name. Required.",
         ),
+        state: Optional[str] = Field(
+            default="open",
+            description="Issue state filter for 'list': 'open', 'closed', or 'all' (default: 'open')",
+        ),
+        creator: Optional[str] = Field(
+            default=None,
+            description="Filter by issue creator username (for 'list')",
+        ),
+        milestone: Optional[str] = Field(
+            default=None,
+            description="Filter by milestone: number, title, '*' (any), or 'none' (for 'list')",
+        ),
+        sort: Optional[str] = Field(
+            default="updated",
+            description="Sort by: 'created', 'updated', or 'comments' (for 'list', default: 'updated')",
+        ),
+        limit: Optional[int] = Field(
+            default=30,
+            description="Maximum issues to return for 'list' action (default: 30)",
+        ),
     ) -> dict:
         """
-        Manage GitHub issues: view, create, update, close, reopen, comment, and sub-issues.
+        Manage GitHub issues: list, view, create, update, close, reopen, comment, and sub-issues.
 
         Supports bulk operations for view/close/reopen/comment via issue_numbers list.
 
         Examples:
+        - list: manage_issues(action="list", state="open", milestone="v1.0")
+        - list by creator: manage_issues(action="list", creator="username")
         - view: manage_issues(action="view", issue_numbers=[42])
         - create: manage_issues(action="create", title="Bug", template="bug_report")
         - create as sub-issue: manage_issues(action="create", title="Task 1", parent_issue=42)
@@ -629,6 +651,26 @@ def create_github_tools(mcp: FastMCP) -> None:
         try:
             client = _get_client()
 
+            # === LIST ACTION ===
+            if action == "list":
+                issues = client.list_issues(
+                    owner=owner,
+                    repo=repo,
+                    state=state or "open",
+                    labels=labels,
+                    assignee=assignees[0] if assignees else None,
+                    creator=creator,
+                    milestone=milestone,
+                    sort=sort or "updated",
+                    limit=limit or 30,
+                )
+                return {
+                    "action": "list",
+                    "state": state or "open",
+                    "count": len(issues),
+                    "issues": issues,
+                }
+
             # === CREATE ACTION ===
             if action == "create":
                 if not title:

{quickcall_integrations-0.3.7.dist-info → quickcall_integrations-0.3.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.3.7
+Version: 0.3.9
 Summary: MCP server with developer integrations for Claude Code and Cursor
 Requires-Python: >=3.10
 Requires-Dist: fastmcp>=2.13.0
@@ -90,7 +90,7 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
 | **Slack** | Read/send messages, threads, channels | Yes |
 
 <details>
-<summary><strong>Available Tools (23)</strong></summary>
+<summary><strong>Available Tools (24)</strong></summary>
 
 ### Git
 | Tool | Description |
@@ -102,10 +102,11 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
 |------|-------------|
 | `list_repos` | List accessible repositories |
 | `list_prs` | List pull requests (open/closed/all) |
-| `get_pr` | Get PR details (title, description, files changed) |
+| `get_prs` | Get PR details (title, description, files changed) |
 | `list_commits` | List commits with optional filters |
 | `get_commit` | Get commit details (message, stats, files) |
 | `list_branches` | List repository branches |
+| `manage_issues` | List, view, create, update, close, reopen, comment on issues + sub-issues |
 | `check_github_connection` | Verify GitHub connection |
 
 ### Slack
@@ -172,9 +173,13 @@ GITHUB_USERNAME=your-username  # Optional: for better UX
 
 **Create a PAT at:** https://github.com/settings/tokens
 
-**Required scopes:**
-- `repo` - Full access to private repositories
-- `public_repo` - Access to public repositories only (if you don't need private repos)
+**Required scopes (classic PAT):**
+
+| Scope | Used For |
+|-------|----------|
+| `project` | GitHub Projects access |
+| `read:user` | Read user profile data |
+| `repo` | PRs, commits, branches, issues |
 
 **Note:** PAT mode provides access to GitHub tools only. For Slack integration, use QuickCall authentication.
 
@@ -228,6 +233,100 @@ List open PRs on [repo] and send titles to #updates channel
 What did I work on this week? Send summary to #standup
 ```
 
+## Issue Management
+
+The `manage_issues` tool provides full issue lifecycle management:
+
+### Actions
+
+| Action | Description |
+|--------|-------------|
+| `list` | List issues with filters |
+| `view` | View issue details |
+| `create` | Create new issue (with optional template) |
+| `update` | Update issue title/body/labels |
+| `close` | Close issue(s) |
+| `reopen` | Reopen issue(s) |
+| `comment` | Add comment to issue(s) |
+| `add_sub_issue` | Add child issue to parent |
+| `remove_sub_issue` | Remove child from parent |
+| `list_sub_issues` | List sub-issues of a parent |
+
+### List Filters
+
+| Filter | Description |
+|--------|-------------|
+| `state` | `'open'`, `'closed'`, or `'all'` (default: `'open'`) |
+| `labels` | Filter by one or more labels |
+| `assignees` | Filter by assignee |
+| `creator` | Filter by issue creator username |
+| `milestone` | Filter by milestone: number, title, `'*'` (any), or `'none'` |
+| `sort` | Sort by: `'created'`, `'updated'`, or `'comments'` (default: `'updated'`) |
+| `limit` | Max issues to return (default: 30) |
+
+**Examples:**
+```
+List open issues in milestone v1.0
+List issues created by sagar
+Show closed bugs sorted by comments
+List issues without a milestone
+```
+
+### Issue Templates
+
+QuickCall supports issue templates from two sources:
+
+**1. GitHub Native Templates** (`.github/ISSUE_TEMPLATE/*.yml`)
+
+Standard GitHub issue templates are automatically detected:
+```yaml
+# .github/ISSUE_TEMPLATE/bug_report.yml
+name: Bug Report
+description: Report a bug
+labels: [bug]
+body:
+  - type: textarea
+    attributes:
+      label: Description
+```
+
+**2. Custom Templates** (`.quickcall.env`)
+
+Define custom templates in your project config:
+```bash
+# .quickcall.env
+ISSUE_TEMPLATE_PATH=/path/to/templates.yml
+```
+
+```yaml
+# templates.yml
+bug_report:
+  name: Bug Report
+  description: Report a bug
+  labels: [bug]
+  title_prefix: "[BUG] "
+  body: |
+    ## Description
+
+    ## Steps to Reproduce
+
+    ## Expected Behavior
+
+feature_request:
+  name: Feature Request
+  labels: [enhancement]
+  body: |
+    ## Problem
+
+    ## Proposed Solution
+```
+
+**Usage:**
+```
+Create a bug report issue titled "Login fails on Safari"
+Create issue with feature_request template
+```
+
 ## Troubleshooting
 
 ### Clean Reinstall

{quickcall_integrations-0.3.7.dist-info → quickcall_integrations-0.3.9.dist-info}/RECORD

@@ -1,7 +1,7 @@
 mcp_server/__init__.py,sha256=6KGzjSPyVB6vQh150DwBjINM_CsZNDhOzwSQFWpXz0U,301
 mcp_server/server.py,sha256=kv5hh0J-M7yENUBBNI1bkq1y7MB0zn5R_-R1tib6_sk,3108
 mcp_server/api_clients/__init__.py,sha256=kOG5_sxIVpAx_tvf1nq_P0QCkqojAVidRE-wenLS-Wc,207
-mcp_server/api_clients/github_client.py,sha256=EXwNEP2u5r5YbVgxyaJO0Yb7eQixMk6QWhid7IIQ5uY,37568
+mcp_server/api_clients/github_client.py,sha256=Mlh6BzMhZ05NqkX9A2O80eJIQXWuW4FnnN1DBM0WKC8,40135
 mcp_server/api_clients/slack_client.py,sha256=w3rcGghttfYw8Ird2beNo2LEYLc3rCTbUKMH4X7QQuQ,16447
 mcp_server/auth/__init__.py,sha256=D-JS0Qe7FkeJjYx92u_AqPx8ZRoB3dKMowzzJXlX6cc,780
 mcp_server/auth/credentials.py,sha256=sDS0W5c16i_UGvhG8Sh1RO93FxRn-hHVAdI9hlWuhx0,20011
@@ -10,12 +10,12 @@ mcp_server/resources/__init__.py,sha256=JrMa3Kf-DmeCB4GwVNfmfw9OGnxF9pJJxCw9Y7u7
 mcp_server/resources/github_resources.py,sha256=sXE06j9jrSDODxH2832fiCtY9n1lKBQR8QZ8U5wYbJY,4030
 mcp_server/resources/slack_resources.py,sha256=b_CPxAicwkF3PsBXIat4QoLbDUHM2g_iPzgzvVpwjaw,1687
 mcp_server/tools/__init__.py,sha256=vIR2ujAaTXm2DgpTsVNz3brI4G34p-Jeg44Qe0uvWc0,405
-mcp_server/tools/auth_tools.py,sha256=kCPjPC1jrVz0XaRAwPea-ue8ybjLLTxyILplBDJ9Mv4,24477
+mcp_server/tools/auth_tools.py,sha256=BPuj9M0pZOvvWHxH0HPdiVm-Y6DJyD-PEvtrIh68vbc,25409
 mcp_server/tools/git_tools.py,sha256=jyCTQR2eSzUFXMt0Y8x66758-VY8YCY14DDUJt7GY2U,13957
-mcp_server/tools/github_tools.py,sha256=ogLo0j1G44LTBIOknPgOG-JgTnLaNLGbLj1UccgWtoE,38337
+mcp_server/tools/github_tools.py,sha256=2YE0RtkfartAuLVUciVFuycqc-B3OhN0uNPwhDm1t48,40053
 mcp_server/tools/slack_tools.py,sha256=-HVE_x3Z1KMeYGi1xhyppEwz5ZF-I-ZD0-Up8yBeoYE,11796
 mcp_server/tools/utility_tools.py,sha256=oxAXpdqtPeB5Ug5dvk54V504r-8v1AO4_px-sO6LFOw,3910
-quickcall_integrations-0.3.7.dist-info/METADATA,sha256=_76mJSIKsz6RU0o6uAmHYEXK9NetNnSMviVycU1T3M0,7070
-quickcall_integrations-0.3.7.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-quickcall_integrations-0.3.7.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
-quickcall_integrations-0.3.7.dist-info/RECORD,,
+quickcall_integrations-0.3.9.dist-info/METADATA,sha256=thgEYROxcB1cBO4BsAunkrS9BIYtyTmLWTe3Fci5qSI,9415
+quickcall_integrations-0.3.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+quickcall_integrations-0.3.9.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
+quickcall_integrations-0.3.9.dist-info/RECORD,,