Claude Code Slack Tether

MCP bridge between Slack and Claude Code

MCP bridge that links business conversations to AI coding agents.
Search Slack, fetch threads, and code with full context — all from VS Code.

1. Ask naturally

2. Tether searches Slack and resolves context

3. Code with full business context

Features

• Slack search & threads — Claude searches your Slack and reads threads on its own
• In-process MCP — no separate server to run; tools are built into the extension
• Multi-turn conversations — ask follow-ups, refine the implementation naturally
• Session persistence — conversations survive VS Code restarts
• Permission control — Ask / Auto-edit / YOLO modes
• One-click Slack connect — OAuth flow, no manual token wrangling

Prerequisites

Tether requires Claude Code CLI to be installed and authenticated. If you already have a Claude subscription (Pro, Team, or Enterprise), you're good — Tether uses your existing subscription. No separate API key or surprise usage bill.

npm install -g @anthropic-ai/claude-code
claude          # follow the prompts to authenticate

Quick Start

1. Install Tether from the VS Code Marketplace
2. Connect Slack — click the Slack button in the chat panel, or run Tether: Configure

   Note: Slack will show a warning that this app is "not approved" or "not distributed" — this is expected. Tether's Slack app is unpublished (Slack's review process requires resources we don't have at the alpha stage). The app is open-source, requests only read permissions, and your token stays on your machine. You can review the full OAuth flow in oauth-proxy/.

3. Start coding — open the chat panel and describe what you need

How It Works

You type in the chat panel
  → Claude Agent SDK starts a conversation
  → Claude calls MCP tools as needed (search_slack, get_slack_thread)
  → MCP tools query your Slack using your own token
  → Claude codes with full business context
  → You follow up, refine, iterate

Your Slack messages stay between you and Slack. Tether searches on your behalf using your own OAuth token. Nothing leaves your machine except the normal Claude API calls.

Why

Every dev team has this workflow:

1. Product discussions happen in Slack
2. Developer gets a task: "implement what we discussed"
3. Developer spends 20 minutes searching Slack, re-reading threads
4. Developer opens AI coding tool and manually explains the context
5. AI implements based on incomplete understanding

Steps 3–4 are pure waste. The context exists — it's just trapped in Slack. Tether bridges the gap:

"Implement what Sarah mentioned last week about rate limiting"

The agent searches conversations, fetches threads, and codes with full business context — no copy-pasting required.

Architecture

Tether is built on two interfaces — BusinessContextProvider and CodingAgent — so anyone can plug in support for their own stack.

Adding a provider touches exactly 3 files. See CONTRIBUTING.md.

Reporting Bugs

Alpha (v0.1.0) — This project is in early alpha. It works, but expect rough edges.

If something breaks, please open an issue. Here's a template you can copy-paste:

**What happened?**
(What did you expect vs. what actually happened)

**Steps to reproduce**
1. ...
2. ...

**Environment**
- OS:
- VS Code version:
- Tether version:
- Claude Code CLI version: (run `claude --version`)

**Logs**
(Open the Output panel → select "Tether" from the dropdown → paste relevant lines)

Contributing

This is an open-source project and contributions are welcome — whether that's bug reports, feature ideas, or PRs.

The most impactful contributions are new providers — each one makes Tether useful for a whole new set of teams.

See CONTRIBUTING.md for a step-by-step guide, and docs/VISION.md for the full roadmap.

License

MIT