Manage your GitHub naturally in your workflows using your voice. Built for VoiceOS
1. Install dependencies
bun install2. Add GitHub as a connected app in Composio
Composio is the auth + API transport this integration runs on. Get an API key from the Composio dashboard, and add GitHub as a connected app for your project — that creates the auth config the connect flow below needs.
3. Give the server the key
Create a .env file in this folder:
COMPOSIO_API_KEY=your-key-here
If you're installing through VoiceOS's setup field instead (it prompts for COMPOSIO_API_KEY and injects it as an env var), this file isn't needed — it's only a fallback for running the server standalone.
4. Install into VoiceOS
Copy (or symlink) this folder into:
~/Library/Application Support/VoiceOS/custom-mcps/
then restart VoiceOS.
5. Connect your account
Try any tool — "What needs my review?" If GitHub isn't connected yet, you'll get a "Connect GitHub" card with an OAuth link. Approve it once and you're set.
| Tool | Does | Try saying | Confirmation? | Type |
|---|---|---|---|---|
my_pull_requests |
Open PRs waiting on you (review-requested and authored) including CI and review status | "What needs my review?" or "What's on my plate in GitHub?" | No | Read |
pull_request_status |
Full status of one PR: per-check pass/fail, reviews, mergeability | "Are checks passing on the voiceOS doordash integration PR?" | No | Read |
list_notifications |
Lists unread GitHub notifications | "Anything new on GitHub?" | No | Read |
create_issue |
Files an issue and polishes your spoken description into a title + body | "File a bug in voiceOS mobile: notch doesn't open smoothly" | Yes | Write |
merge_pull_request |
Merges a PR (default squash) | "Merge it" | Yes | Write |