@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.
- package/README.md +30 -14
- package/package.json +27 -3
- package/public/demo.html +16 -0
package/README.md
CHANGED
|
@@ -1,14 +1,30 @@
|
|
|
1
1
|
# Slack MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
*Full workspace access via local session mirroring. DMs, threads, and history—no admin approval required.*
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
37
|
+
## Architecture: Local Session Mirroring
|
|
22
38
|
|
|
23
|
-
|
|
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["
|
|
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["
|
|
60
|
-
G[Open Slack in Chrome] --> H[
|
|
75
|
+
subgraph ThisServer["Session Mirroring"]
|
|
76
|
+
G[Open Slack in Chrome] --> H[Mirror Session]
|
|
61
77
|
H --> I[Full Access]
|
|
62
|
-
I --> J["
|
|
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
|
-
**
|
|
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.
|
|
4
|
-
"description": "
|
|
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">
|