@jtalk22/slack-mcp 3.0.0 → 3.2.0

package/lib/tools.js

@@ -268,5 +268,136 @@ export const TOOLS = [
       idempotentHint: true,
       openWorldHint: true
     }
+  },
+  {
+    name: "slack_add_reaction",
+    description: "Add an emoji reaction to a message",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID containing the message"
+        },
+        timestamp: {
+          type: "string",
+          description: "Message timestamp to react to"
+        },
+        reaction: {
+          type: "string",
+          description: "Emoji name without colons (e.g., 'thumbsup', 'eyes', 'white_check_mark')"
+        }
+      },
+      required: ["channel_id", "timestamp", "reaction"]
+    },
+    annotations: {
+      title: "Add Reaction",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  {
+    name: "slack_remove_reaction",
+    description: "Remove an emoji reaction from a message",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID containing the message"
+        },
+        timestamp: {
+          type: "string",
+          description: "Message timestamp to remove reaction from"
+        },
+        reaction: {
+          type: "string",
+          description: "Emoji name without colons (e.g., 'thumbsup', 'eyes')"
+        }
+      },
+      required: ["channel_id", "timestamp", "reaction"]
+    },
+    annotations: {
+      title: "Remove Reaction",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  {
+    name: "slack_conversations_mark",
+    description: "Mark a conversation as read up to a specific message timestamp",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID to mark as read"
+        },
+        timestamp: {
+          type: "string",
+          description: "Message timestamp to mark as read up to (all messages at or before this are marked read)"
+        }
+      },
+      required: ["channel_id", "timestamp"]
+    },
+    annotations: {
+      title: "Mark as Read",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  {
+    name: "slack_conversations_unreads",
+    description: "Get channels and DMs with unread messages, sorted by unread count (highest first)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        types: {
+          type: "string",
+          description: "Comma-separated types: im, mpim, public_channel, private_channel (default all)",
+          default: "im,mpim,public_channel,private_channel"
+        },
+        limit: {
+          type: "number",
+          description: "Maximum conversations to return (default 50)"
+        }
+      }
+    },
+    annotations: {
+      title: "Unread Conversations",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  },
+  {
+    name: "slack_users_search",
+    description: "Search workspace users by name, display name, or email. Case-insensitive partial match.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Search term to match against name, display name, real name, or email"
+        },
+        limit: {
+          type: "number",
+          description: "Maximum results to return (default 20)"
+        }
+      },
+      required: ["query"]
+    },
+    annotations: {
+      title: "Search Users",
+      readOnlyHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    }
   }
 ];

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "3.0.0",
-  "description": "Session-based Slack access for Claude - DMs, channels, search, and threads. Local-first with your existing Slack session.",
+  "version": "3.2.0",
+  "description": "Session-based Slack MCP for Claude and MCP clients: local-first workflows, secure-default HTTP.",
   "type": "module",
   "main": "src/server.js",
   "bin": {
@@ -24,56 +24,52 @@
     "tokens:auto": "node scripts/token-cli.js auto",
     "tokens:clear": "node scripts/token-cli.js clear",
     "screenshot": "node scripts/capture-screenshots.js",
+    "build:social-preview": "node scripts/build-social-preview.js",
+    "build:demo-mobile": "node scripts/build-mobile-demo.js",
+    "build:demo-mobile:gif": "node scripts/build-mobile-demo.js --gif",
     "record-demo": "node scripts/record-demo.js",
+    "social-preview:update": "node scripts/update-github-social-preview.js --headed",
     "cf:browser": "node scripts/cloudflare-browser-tool.js",
     "metrics:release-health": "node scripts/collect-release-health.js",
     "metrics:release-health:delta": "node scripts/build-release-health-delta.js",
+    "impact:push:v3": "node scripts/impact-push-v3.js --dry-run",
+    "impact:push:v3:apply": "node scripts/impact-push-v3.js --apply",
     "verify:version-parity": "node scripts/check-version-parity.js",
     "verify:release-dry-run": "node scripts/release-preflight.js"
   },
   "keywords": [
+    "claude",
     "mcp",
-    "mcp-server",
     "model-context-protocol",
     "slack",
     "slack-api",
-    "slack-mcp",
-    "slack-integration",
-    "claude",
     "claude-desktop",
-    "claude-code",
-    "claude-connectors",
-    "anthropic",
-    "cursor",
-    "llm",
-    "automation",
-    "workflow-automation",
-    "developer-tools",
     "cli",
-    "productivity",
-    "messaging",
-    "message-search",
-    "direct-messages",
-    "channels",
-    "workspace",
+    "developer-tools",
+    "mcp-server",
     "session-based",
+    "claude-code",
+    "local-first",
     "session-mirroring",
-    "slack-dm",
-    "slack-threads",
-    "workspace-search",
-    "mcp-tools",
-    "mcp-stdio",
-    "mcp-http",
-    "remote-mcp",
-    "open-source"
+    "slack-mcp",
+    "secure-by-default",
+    "llm",
+    "slack-integration",
+    "ai-agents",
+    "automation",
+    "productivity"
   ],
-  "author": "jtalk22",
+  "author": {
+    "name": "James Lambert",
+    "email": "james@revasser.nyc",
+    "url": "https://github.com/jtalk22"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jtalk22/slack-mcp-server.git"
   },
-  "homepage": "https://jtalk22.github.io/slack-mcp-server/public/demo.html",
+  "homepage": "https://jtalk22.github.io/slack-mcp-server/",
   "bugs": {
     "url": "https://github.com/jtalk22/slack-mcp-server/issues"
   },
@@ -87,12 +83,15 @@
   "files": [
     "src/",
     "lib/",
-    "public/",
-    "scripts/",
-    "docs/*.md",
-    "docs/assets/",
-    "docs/images/*.png",
-    "docs/images/*.svg",
+    "public/index.html",
+    "public/share.html",
+    "scripts/setup-wizard.js",
+    "scripts/token-cli.js",
+    "docs/SETUP.md",
+    "docs/API.md",
+    "docs/TROUBLESHOOTING.md",
+    "docs/assets/icon.svg",
+    "docs/assets/icon-512.png",
     "README.md",
     "LICENSE",
     "server.json",

package/public/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Slack Web API</title>
+  <title>Slack MCP Server — Web Dashboard</title>
   <style>
     @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600&family=Space+Grotesk:wght@500;600;700&display=swap');
 
@@ -253,7 +253,11 @@
   </div>
 
   <div class="container">
-    <h1>Slack Web API <span id="status" class="status"></span></h1>
+    <h1>Slack Web API <span style="font-size:0.55em;opacity:0.5;font-weight:400;vertical-align:middle">v3.2.0</span> <span id="status" class="status"></span></h1>
+    <div style="background:rgba(240,194,70,0.08);border:1px solid rgba(240,194,70,0.2);border-radius:8px;padding:8px 14px;margin-bottom:16px;display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:8px;font-size:13px;color:#d4c48a">
+      <span>Skip local setup? <strong style="color:#f0c246">Slack MCP Cloud</strong> gives you 16 tools with one URL — no tokens to manage.</span>
+      <a href="https://jtalk22.github.io/slack-mcp-server/cloud.html" style="color:#f0c246;font-weight:600;text-decoration:none;white-space:nowrap" target="_blank">Learn more &rarr;</a>
+    </div>
     <div class="grid">
       <div class="sidebar">
         <h3>CONVERSATIONS</h3>
@@ -267,7 +271,7 @@
       </div>
       <div class="main-panel">
         <div class="search-section">
-          <input type="text" id="searchQuery" placeholder="Search messages...">
+          <input type="text" id="searchQuery" placeholder="Search messages..." onkeypress="if(event.key==='Enter')searchMessages()">
           <button onclick="searchMessages()">Search</button>
         </div>
         <h2 id="channelName">Select a conversation</h2>
@@ -377,7 +381,7 @@
       try {
         const data = await api('/conversations?types=' + types);
         list.innerHTML = data.conversations.map(c =>
-          '<li onclick="loadHistory(\'' + c.id + '\', \'' + c.name.replace(/'/g, "\\'") + '\', this)"><div>' + c.name + '</div><div class="type">' + c.type + '</div></li>'
+          '<li onclick="loadHistory(\'' + c.id + '\', \'' + escapeHtml(c.name).replace(/'/g, "&#39;") + '\', this)"><div>' + escapeHtml(c.name) + '</div><div class="type">' + escapeHtml(c.type) + '</div></li>'
         ).join('');
       } catch (e) { list.innerHTML = '<li class="error-msg">' + e.message + '</li>'; }
     }
@@ -397,7 +401,7 @@
       const container = document.getElementById('messages');
       if (!messages || messages.length === 0) { container.innerHTML = '<div class="loading">No messages</div>'; return; }
       container.innerHTML = messages.map(m =>
-        '<div class="message"><div class="header"><span class="user">' + (m.user || m.user_id || 'Unknown') + '</span><span class="time">' + new Date(m.datetime).toLocaleString() + '</span></div><div class="text">' + escapeHtml(m.text || '') + '</div></div>'
+        '<div class="message"><div class="header"><span class="user">' + escapeHtml(m.user || m.user_id || 'Unknown') + '</span><span class="time">' + new Date(m.datetime).toLocaleString() + '</span></div><div class="text">' + escapeHtml(m.text || '') + '</div></div>'
       ).join('');
       container.scrollTop = container.scrollHeight;
     }
@@ -423,7 +427,7 @@
         const data = await api('/search?q=' + encodeURIComponent(query));
         if (data.matches && data.matches.length > 0) {
           container.innerHTML = data.matches.map(m =>
-            '<div class="message"><div class="header"><span class="user">' + (m.user || 'Unknown') + ' in #' + m.channel + '</span><span class="time">' + new Date(m.datetime).toLocaleString() + '</span></div><div class="text">' + escapeHtml(m.text || '') + '</div></div>'
+            '<div class="message"><div class="header"><span class="user">' + escapeHtml(m.user || 'Unknown') + ' in #' + escapeHtml(m.channel || '') + '</span><span class="time">' + new Date(m.datetime).toLocaleString() + '</span></div><div class="text">' + escapeHtml(m.text || '') + '</div></div>'
           ).join('');
         } else { container.innerHTML = '<div class="loading">No results found</div>'; }
       } catch (e) { container.innerHTML = '<div class="error-msg">' + e.message + '</div>'; }

package/public/share.html

@@ -0,0 +1,128 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Slack MCP Server v3.2.0</title>
+  <meta name="description" content="Session-based Slack MCP for Claude. Local-first stdio/web with secure-default hosted HTTP in v3.">
+  <meta property="og:type" content="website">
+  <meta property="og:title" content="Slack MCP Server v3.2.0">
+  <meta property="og:description" content="Session-based Slack MCP for Claude. Local-first stdio/web with secure-default hosted HTTP in v3.">
+  <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/share.html">
+  <meta property="og:image" content="https://jtalk22.github.io/slack-mcp-server/docs/images/social-preview-v3.png">
+  <meta property="og:image:width" content="1280">
+  <meta property="og:image:height" content="640">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:title" content="Slack MCP Server v3.2.0">
+  <meta name="twitter:description" content="Session-based Slack MCP for Claude. Local-first stdio/web with secure-default hosted HTTP in v3.">
+  <meta name="twitter:image" content="https://jtalk22.github.io/slack-mcp-server/docs/images/social-preview-v3.png">
+  <style>
+    :root {
+      --bg-1: #0b1436;
+      --bg-2: #0e1d49;
+      --line: rgba(131, 161, 224, 0.36);
+      --text: #edf4ff;
+      --muted: #b4c4e8;
+      --link-bg: rgba(17, 57, 120, 0.7);
+      --link-bg-hover: rgba(22, 71, 148, 0.85);
+      --accent: #54d8cf;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      color: var(--text);
+      background:
+        radial-gradient(900px 430px at 12% 0%, #2b4f98 0%, transparent 60%),
+        radial-gradient(980px 480px at 100% 100%, #124b8c 0%, transparent 64%),
+        linear-gradient(145deg, var(--bg-1), var(--bg-2));
+      font-family: "Space Grotesk", "IBM Plex Sans", "Segoe UI", Arial, sans-serif;
+      display: grid;
+      place-items: center;
+      padding: 20px;
+    }
+    .wrap {
+      width: min(980px, 100%);
+      border: 1px solid var(--line);
+      border-radius: 16px;
+      background: linear-gradient(165deg, rgba(17, 41, 92, 0.72), rgba(10, 22, 56, 0.9));
+      box-shadow: 0 18px 38px rgba(0, 0, 0, 0.28);
+      padding: 16px;
+    }
+    h1 {
+      margin: 0;
+      line-height: 1.08;
+      letter-spacing: -0.02em;
+      font-size: clamp(30px, 5vw, 48px);
+    }
+    .sub {
+      margin: 8px 0 14px;
+      color: var(--muted);
+      font-size: clamp(16px, 2.4vw, 22px);
+      line-height: 1.25;
+    }
+    .preview {
+      display: block;
+      border-radius: 12px;
+      overflow: hidden;
+      border: 1px solid rgba(135, 163, 225, 0.4);
+      text-decoration: none;
+      margin-bottom: 14px;
+    }
+    .preview img {
+      width: 100%;
+      display: block;
+    }
+    .links {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 10px;
+      margin-bottom: 8px;
+    }
+    .links a {
+      display: inline-block;
+      text-decoration: none;
+      border: 1px solid rgba(131, 161, 224, 0.5);
+      border-radius: 10px;
+      padding: 9px 12px;
+      color: var(--text);
+      background: var(--link-bg);
+      font-weight: 600;
+      font-size: 14px;
+    }
+    .links a:hover { background: var(--link-bg-hover); }
+    .note {
+      color: #9fb4de;
+      font-size: 13px;
+      line-height: 1.45;
+    }
+    .note strong { color: var(--accent); }
+    @media (max-width: 640px) {
+      body { padding: 10px; }
+      .wrap { padding: 12px; }
+    }
+  </style>
+</head>
+<body>
+  <main class="wrap">
+    <h1>Slack MCP Server v3.2.0</h1>
+    <p class="sub">Give Claude full access to your Slack. Read channels, search messages, send replies, get AI summaries. Self-host free or Cloud from $19/mo.</p>
+
+    <a class="preview" href="https://github.com/jtalk22/slack-mcp-server" rel="noopener">
+      <img src="https://jtalk22.github.io/slack-mcp-server/docs/images/social-preview-v3.png" alt="Slack MCP Server social preview card">
+    </a>
+
+    <div class="links">
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md" rel="noopener">Install (`--setup`)</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/README.md#install--verify" rel="noopener">Verify (`--version/--doctor/--status`)</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server/releases/latest" rel="noopener">Latest Release</a>
+      <a href="https://jtalk22.github.io/slack-mcp-server/" rel="noopener">Autoplay Demo Landing</a>
+      <a href="https://jtalk22.github.io/slack-mcp-server/docs/videos/demo-claude-mobile-20s.mp4" rel="noopener">20s Mobile Clip</a>
+      <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" rel="noopener">npm Package</a>
+      <a href="https://jtalk22.github.io/slack-mcp-server/cloud.html" rel="noopener" style="background:rgba(240,194,70,0.18);border-color:rgba(240,194,70,0.45);color:#f0c246">Cloud ($19/mo)</a>
+    </div>
+
+    <p class="note"><strong>Verify in 30 seconds:</strong> <code>--version</code>, <code>--doctor</code>, <code>--status</code>. Maintainer/operator: <code>jtalk22</code> (<code>james@revasser.nyc</code>).</p>
+  </main>
+</body>
+</html>

package/scripts/setup-wizard.js

@@ -23,7 +23,7 @@ import {
 } from "../lib/token-store.js";
 
 const IS_MACOS = platform() === 'darwin';
-const VERSION = "3.0.0";
+const VERSION = "3.2.0";
 const MIN_NODE_MAJOR = 20;
 const AUTH_TEST_URL = process.env.SLACK_MCP_AUTH_TEST_URL || "https://slack.com/api/auth.test";
 

package/server.json

@@ -2,8 +2,8 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.jtalk22/slack-mcp-server",
   "title": "Slack MCP Server",
-  "description": "Session-based Slack access for Claude: DMs, channels, search, and threads via your Slack session.",
-  "websiteUrl": "https://jtalk22.github.io/slack-mcp-server/public/demo.html",
+  "description": "Session-based Slack MCP for Claude and MCP clients: local-first workflows, secure-default HTTP.",
+  "websiteUrl": "https://jtalk22.github.io/slack-mcp-server/",
   "icons": [
     {
       "src": "https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/assets/icon-512.png",
@@ -17,12 +17,18 @@
     "url": "https://github.com/jtalk22/slack-mcp-server",
     "source": "github"
   },
-  "version": "3.0.0",
+  "version": "3.2.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.revasserlabs.com/oauth/mcp"
+    }
+  ],
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@jtalk22/slack-mcp",
-      "version": "3.0.0",
+      "version": "3.2.0",
       "transport": {
         "type": "stdio"
       },

package/src/server-http.js

@@ -27,10 +27,15 @@ import {
   handleSendMessage,
   handleGetThread,
   handleListUsers,
+  handleAddReaction,
+  handleRemoveReaction,
+  handleConversationsMark,
+  handleConversationsUnreads,
+  handleUsersSearch,
 } from "../lib/handlers.js";
 
 const SERVER_NAME = "slack-mcp-server";
-const SERVER_VERSION = "3.0.0";
+const SERVER_VERSION = "3.2.0";
 const PORT = process.env.PORT || 3000;
 const HTTP_INSECURE = process.env.SLACK_MCP_HTTP_INSECURE === "1";
 const HTTP_AUTH_TOKEN = process.env.SLACK_MCP_HTTP_AUTH_TOKEN || process.env.SLACK_API_KEY || null;
@@ -115,6 +120,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleGetThread(args);
       case "slack_list_users":
         return await handleListUsers(args);
+      case "slack_add_reaction":
+        return await handleAddReaction(args);
+      case "slack_remove_reaction":
+        return await handleRemoveReaction(args);
+      case "slack_conversations_mark":
+        return await handleConversationsMark(args);
+      case "slack_conversations_unreads":
+        return await handleConversationsUnreads(args);
+      case "slack_users_search":
+        return await handleUsersSearch(args);
       default:
         return {
           content: [{

package/src/server.js

@@ -11,7 +11,7 @@
  * - Network error retry with exponential backoff
  * - Background token health monitoring
  *
- * @version 3.0.0
+ * @version 3.2.0
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -41,6 +41,11 @@ import {
   handleSendMessage,
   handleGetThread,
   handleListUsers,
+  handleAddReaction,
+  handleRemoveReaction,
+  handleConversationsMark,
+  handleConversationsUnreads,
+  handleUsersSearch,
 } from "../lib/handlers.js";
 
 // Background refresh interval (4 hours)
@@ -48,7 +53,7 @@ const BACKGROUND_REFRESH_INTERVAL = 4 * 60 * 60 * 1000;
 
 // Package info
 const SERVER_NAME = "slack-mcp-server";
-const SERVER_VERSION = "3.0.0";
+const SERVER_VERSION = "3.2.0";
 
 // MCP Prompts - predefined prompt templates for common Slack operations
 const PROMPTS = [
@@ -255,6 +260,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "slack_list_users":
         return await handleListUsers(args);
 
+      case "slack_add_reaction":
+        return await handleAddReaction(args);
+
+      case "slack_remove_reaction":
+        return await handleRemoveReaction(args);
+
+      case "slack_conversations_mark":
+        return await handleConversationsMark(args);
+
+      case "slack_conversations_unreads":
+        return await handleConversationsUnreads(args);
+
+      case "slack_users_search":
+        return await handleUsersSearch(args);
+
       default:
         return {
           content: [{
@@ -306,11 +326,15 @@ async function main() {
   // Use unref() so this timer doesn't prevent the process from exiting
   // when the MCP transport closes (prevents zombie processes)
   const backgroundTimer = setInterval(async () => {
-    const health = await checkTokenHealth(console);
-    if (health.refreshed) {
-      console.error("Background: tokens refreshed successfully");
-    } else if (health.critical) {
-      console.error("Background: tokens critical - open Slack in Chrome");
+    try {
+      const health = await checkTokenHealth(console);
+      if (health.refreshed) {
+        console.error("Background: tokens refreshed successfully");
+      } else if (health.critical) {
+        console.error("Background: tokens critical - open Slack in Chrome");
+      }
+    } catch (err) {
+      console.error(`Background health check failed: ${err.message}`);
     }
   }, BACKGROUND_REFRESH_INTERVAL);
   backgroundTimer.unref();