Metadata-Version: 2.4
Name: quickcall-integrations
Version: 0.1.7
Summary: MCP server with developer integrations for Claude Code and Cursor
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.13.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: pydantic>=2.11.7
Requires-Dist: pygithub>=2.8.1
Requires-Dist: rapidfuzz>=3.0.0
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://quickcall.dev/assets/v1/qc-full-512px-white.png" alt="QuickCall" width="400">
</p>

<h3 align="center">Eliminate interruptions for developers</h3>

<p align="center">
  <em>Ask about your work, get instant answers. No more context switching.</em>
</p>

<p align="center">
  <a href="https://quickcall.dev"><img src="https://img.shields.io/badge/Web-quickcall.dev-000000?logo=googlechrome&logoColor=white" alt="Web"></a>
  <a href="https://discord.gg/DtnMxuE35v"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
</p>

<p align="center">
  <a href="#integrations">Integrations</a> |
  <a href="#install">Install</a> |
  <a href="#authentication">Authentication</a> |
  <a href="#commands">Commands</a> |
  <a href="#troubleshooting">Troubleshooting</a>
</p>

---

## Capabilities

- **Get standup updates** from git history (commits, diffs, stats)
- **List PRs, commits, branches** from GitHub repos
- **Send messages to Slack** channels
- **Check connection status** for all integrations

## Integrations

| Integration | Features | Auth Required |
|-------------|----------|---------------|
| **Git** | Commits, diffs, standup summaries | No |
| **GitHub** | Repos, PRs, commits, branches | Yes |
| **Slack** | Read/send messages, threads, channels | Yes |

<details>
<summary><strong>Available Tools (22)</strong></summary>

### Git
| Tool | Description |
|------|-------------|
| `get_updates` | Get git commits, diff stats, and uncommitted changes |

### GitHub
| Tool | Description |
|------|-------------|
| `list_repos` | List accessible repositories |
| `list_prs` | List pull requests (open/closed/all) |
| `get_pr` | 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 |
| `check_github_connection` | Verify GitHub connection |

### Slack
| Tool | Description |
|------|-------------|
| `list_slack_channels` | List channels bot has access to |
| `send_slack_message` | Send message to a channel |
| `read_slack_messages` | Read messages from a channel (with date filter) |
| `read_slack_thread` | Read replies in a thread |
| `list_slack_users` | List workspace users |
| `check_slack_connection` | Verify Slack connection |

### Auth
| Tool | Description |
|------|-------------|
| `connect_quickcall` | Start device flow authentication |
| `check_quickcall_status` | Check connection status |
| `disconnect_quickcall` | Remove local credentials |
| `connect_github` | Install GitHub App |
| `connect_slack` | Authorize Slack App |

### Utility
| Tool | Description |
|------|-------------|
| `get_current_datetime` | Get current UTC datetime |
| `calculate_date_range` | Calculate date range for queries |
| `calculate_date_offset` | Add/subtract time from a date |

</details>

## Install

### Claude Code

```
/plugin marketplace add quickcall-dev/quickcall-integrations
/plugin install quickcall@quickcall-integrations
```

<details>
<summary>MCP only (without plugin)</summary>

```bash
claude mcp add quickcall -- uvx quickcall-integrations
```
</details>

<details>
<summary>Update to latest version</summary>

```
/plugin marketplace update quickcall-integrations
/plugin uninstall quickcall
/plugin install quickcall@quickcall-integrations
```

After updating, restart Claude Code or open a new terminal.
</details>

### Cursor

Add to your Cursor MCP config (`~/.cursor/mcp.json` for global, or `.cursor/mcp.json` for project):

```json
{
  "mcpServers": {
    "quickcall": {
      "command": "uvx",
      "args": ["quickcall-integrations"]
    }
  }
}
```

Then restart Cursor.

> Also works with [Antigravity](https://antigravity.dev) and any other IDE that supports MCP servers.

## Authentication

To use GitHub and Slack integrations, connect your QuickCall account:

```
/quickcall:connect
```

This will guide you through:
1. Sign in with Google
2. Install GitHub App to your org/account
3. Connect Slack workspace

Credentials are stored locally in `~/.quickcall/credentials.json`.

## Commands

### Claude Code

| Command | Description |
|---------|-------------|
| `/quickcall:connect` | Connect QuickCall, GitHub, and Slack |
| `/quickcall:status` | Show connection status |
| `/quickcall:updates` | Get git updates (default: 1 day) |
| `/quickcall:updates 7d` | Get updates for last 7 days |

### Cursor / Other IDEs

Ask the AI naturally - see examples below.

## Example Prompts

### Git
```
What did I work on today?
Give me a standup summary for the last 3 days
What changes are uncommitted?
```

### GitHub
```
List my repos
Show open PRs on [repo-name]
What commits were made this week?
Get details of PR #123
List branches on [repo-name]
```

### Slack
```
Send "Build completed" to #deployments
What messages were posted in #general today?
Show me the thread replies for that message
List channels I have access to
```

### Combined
```
List open PRs on [repo] and send titles to #updates channel
What did I work on this week? Send summary to #standup
```

## Troubleshooting

### Plugin Not Updating?

If new commands don't appear after updating, clear the cache:

```bash
rm -rf ~/.claude/plugins/cache/quickcall-integrations
rm -rf ~/.claude/plugins/marketplaces/quickcall-integrations
```

Then restart Claude Code and reinstall:

```
/plugin marketplace add quickcall-dev/quickcall-integrations
/plugin install quickcall@quickcall-integrations
```

### Commands Not Showing?

Type `/quickcall:` - you should see `connect`, `status`, `updates`.

If only `updates` shows, run the cleanup above and reinstall.

---

<p align="center">
  Built with ❤️ by <a href="https://quickcall.dev">QuickCall</a>
</p>
