@jtalk22/slack-mcp 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +30 -14
  2. package/package.json +27 -3
  3. package/public/demo.html +16 -0
package/README.md CHANGED
@@ -1,14 +1,30 @@
1
1
  # Slack MCP Server
2
2
 
3
- [![Live Demo](https://img.shields.io/badge/Demo-Try%20Simulator-blue?style=for-the-badge)](https://jtalk22.github.io/slack-mcp-server/public/demo.html)
3
+ *Full workspace access via local session mirroring. DMs, threads, and history—no admin approval required.*
4
4
 
5
- [![npm](https://img.shields.io/npm/v/@jtalk22/slack-mcp?color=blue)](https://www.npmjs.com/package/@jtalk22/slack-mcp)
6
- [![Docker](https://img.shields.io/badge/docker-ghcr.io-blue)](https://github.com/jtalk22/slack-mcp-server/pkgs/container/slack-mcp-server)
7
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
- [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
9
- [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/jtalk22/slack-mcp-server/pulls)
5
+ <p align="center">
6
+ <a href="https://jtalk22.github.io/slack-mcp-server/public/demo.html">
7
+ <img src="https://img.shields.io/badge/LIVE%20DEMO-Try%20It%20Now-00C853?style=for-the-badge&logo=slack&logoColor=white" alt="Live Demo - Try It Now" height="50">
8
+ </a>
9
+ </p>
10
+
11
+ <p align="center">
12
+ <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp"><img src="https://img.shields.io/npm/v/@jtalk22/slack-mcp?color=blue&label=npm" alt="npm"></a>
13
+ <a href="https://github.com/jtalk22/slack-mcp-server/pkgs/container/slack-mcp-server"><img src="https://img.shields.io/badge/docker-ghcr.io-blue" alt="Docker"></a>
14
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
15
+ <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="Node.js"></a>
16
+ <a href="https://github.com/sponsors/jtalk22"><img src="https://img.shields.io/github/sponsors/jtalk22?label=Sponsor&logo=github" alt="GitHub Sponsors"></a>
17
+ </p>
18
+
19
+ ---
20
+
21
+ ### Why This Exists
22
+
23
+ I built this because I was working with someone to help me manage a complex workload, and we kept hitting walls. They needed context from my messages—"what did X say about Y?"—but Slack's API blocks access to DMs without admin approval.
24
+
25
+ Screenshotting messages is not a workflow.
10
26
 
11
- A [Model Context Protocol](https://modelcontextprotocol.io/) server that gives Claude **unrestricted access** to your Slack workspace - including DMs, private channels, and full message history. No OAuth. No app approval. No per-conversation authorization.
27
+ This server bridges the gap. It creates a secure, local bridge between Claude and your Slack web session. It gives your AI the same access **you** already have in the browser—search history, summarize threads, find that thing someone sent you three weeks ago—without fighting the platform.
12
28
 
13
29
  <p align="center">
14
30
  <img src="docs/images/demo-main.png" alt="Slack MCP Server Web UI" width="800">
@@ -18,9 +34,9 @@ A [Model Context Protocol](https://modelcontextprotocol.io/) server that gives C
18
34
 
19
35
  ---
20
36
 
21
- ## How It Works: The Cookie Heist
37
+ ## Architecture: Local Session Mirroring
22
38
 
23
- This server bypasses Slack's OAuth entirely by extracting your browser session tokens. You already have access to everything in Slack's web interface - we just give that same access to Claude.
39
+ Instead of authenticating as a bot, this server leverages your existing Chrome session credentials (macOS) or manual token injection (Linux/Windows). It mirrors your user access exactly—if you can see it in Slack, Claude can see it too.
24
40
 
25
41
  ```mermaid
26
42
  sequenceDiagram
@@ -48,7 +64,7 @@ sequenceDiagram
48
64
 
49
65
  ```mermaid
50
66
  flowchart LR
51
- subgraph Traditional["Traditional Slack App (OAuth)"]
67
+ subgraph Traditional["Official Slack API (OAuth)"]
52
68
  A[Create App] --> B[Request Scopes]
53
69
  B --> C[Admin Approval]
54
70
  C --> D[User Authorization]
@@ -56,17 +72,17 @@ flowchart LR
56
72
  E --> F["No DMs without<br/>per-conversation consent"]
57
73
  end
58
74
 
59
- subgraph ThisServer["This Server (Browser Tokens)"]
60
- G[Open Slack in Chrome] --> H[Extract Session]
75
+ subgraph ThisServer["Session Mirroring"]
76
+ G[Open Slack in Chrome] --> H[Mirror Session]
61
77
  H --> I[Full Access]
62
- I --> J["All DMs, Channels,<br/>Search, Everything"]
78
+ I --> J["Your DMs, Channels,<br/>Search, History"]
63
79
  end
64
80
 
65
81
  style Traditional fill:#ffcccc
66
82
  style ThisServer fill:#ccffcc
67
83
  ```
68
84
 
69
- **The trade-off:** Tokens expire every 1-2 weeks, but auto-refresh keeps things running seamlessly.
85
+ **Trade-off:** Session tokens expire every 1-2 weeks. Auto-refresh (macOS) or manual update keeps things running.
70
86
 
71
87
  ---
72
88
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@jtalk22/slack-mcp",
3
- "version": "1.1.2",
4
- "description": "MCP server for Slack - Full access to DMs, channels, and messages from Claude. Browser token auth, no OAuth required.",
3
+ "version": "1.1.4",
4
+ "description": "Full Slack access for Claude - DMs, channels, search. No OAuth. No admin approval. Just works.",
5
5
  "type": "module",
6
6
  "main": "src/server.js",
7
7
  "bin": {
@@ -23,21 +23,45 @@
23
23
  "slack",
24
24
  "slack-api",
25
25
  "slack-mcp",
26
+ "slack-bot",
27
+ "slack-integration",
26
28
  "claude",
27
29
  "claude-desktop",
28
30
  "claude-code",
29
31
  "anthropic",
30
32
  "ai",
31
33
  "ai-assistant",
34
+ "ai-agent",
32
35
  "llm",
36
+ "llm-tools",
33
37
  "chatbot",
34
38
  "dm",
35
39
  "direct-messages",
36
40
  "channels",
37
41
  "workspace",
38
42
  "automation",
43
+ "workflow-automation",
39
44
  "browser-tokens",
40
- "no-oauth"
45
+ "no-oauth",
46
+ "cli",
47
+ "developer-tools",
48
+ "devtools",
49
+ "productivity",
50
+ "messaging",
51
+ "chat",
52
+ "model-context-protocol",
53
+ "chatgpt",
54
+ "cursor",
55
+ "open-source",
56
+ "openai",
57
+ "gpt",
58
+ "gemini",
59
+ "copilot",
60
+ "ai-tools",
61
+ "personal-assistant",
62
+ "message-search",
63
+ "slack-integration",
64
+ "workspace-automation"
41
65
  ],
42
66
  "funding": {
43
67
  "type": "individual",
package/public/demo.html CHANGED
@@ -4,6 +4,22 @@
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
6
  <title>Slack MCP Server - Interactive Demo</title>
7
+
8
+ <!-- Open Graph / Social Sharing -->
9
+ <meta property="og:type" content="website">
10
+ <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/demo.html">
11
+ <meta property="og:title" content="Slack MCP Server - Direct Access for Claude">
12
+ <meta property="og:description" content="Give Claude full access to DMs and Channels without OAuth. Try the interactive simulator.">
13
+ <meta property="og:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-main.png">
14
+
15
+ <!-- Twitter Card -->
16
+ <meta name="twitter:card" content="summary_large_image">
17
+ <meta name="twitter:title" content="Slack MCP Server - Direct Access for Claude">
18
+ <meta name="twitter:description" content="Give Claude full access to DMs and Channels without OAuth. Try the interactive simulator.">
19
+ <meta name="twitter:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-main.png">
20
+
21
+ <!-- SEO -->
22
+ <meta name="description" content="Full Slack access for Claude - DMs, channels, search. No OAuth. No admin approval. Interactive demo simulator.">
7
23
  <link rel="preconnect" href="https://fonts.googleapis.com">
8
24
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
9
25
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">