@jtalk22/slack-mcp 1.0.0

package/lib/tools.js

@@ -0,0 +1,191 @@
+/**
+ * MCP Tool Definitions
+ *
+ * All Slack MCP tools in one place for easy maintenance.
+ */
+
+export const TOOLS = [
+  {
+    name: "slack_health_check",
+    description: "Check if Slack tokens are valid and show authentication status",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "slack_refresh_tokens",
+    description: "Force refresh tokens by extracting from Chrome (requires Slack tab open in Chrome)",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "slack_list_conversations",
+    description: "List all DMs and channels with user names resolved",
+    inputSchema: {
+      type: "object",
+      properties: {
+        types: {
+          type: "string",
+          description: "Comma-separated types: im, mpim, public_channel, private_channel",
+          default: "im,mpim"
+        },
+        limit: {
+          type: "number",
+          description: "Maximum results (default 100)"
+        }
+      }
+    }
+  },
+  {
+    name: "slack_conversations_history",
+    description: "Get messages from a channel or DM with user names resolved",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID (e.g., D063M4403MW)"
+        },
+        limit: {
+          type: "number",
+          description: "Messages to fetch (max 100, default 50)"
+        },
+        oldest: {
+          type: "string",
+          description: "Unix timestamp - get messages after this time"
+        },
+        latest: {
+          type: "string",
+          description: "Unix timestamp - get messages before this time"
+        },
+        resolve_users: {
+          type: "boolean",
+          description: "Convert user IDs to names (default true)"
+        }
+      },
+      required: ["channel_id"]
+    }
+  },
+  {
+    name: "slack_get_full_conversation",
+    description: "Export FULL conversation history with all messages, threads, and user names. Can save to file.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID"
+        },
+        oldest: {
+          type: "string",
+          description: "Unix timestamp start (e.g., 1733011200 = Dec 1, 2025)"
+        },
+        latest: {
+          type: "string",
+          description: "Unix timestamp end"
+        },
+        max_messages: {
+          type: "number",
+          description: "Maximum messages to retrieve (default 2000, max 10000)"
+        },
+        include_threads: {
+          type: "boolean",
+          description: "Fetch thread replies (default true)"
+        },
+        output_file: {
+          type: "string",
+          description: "Save to file path (optional, relative to home directory)"
+        }
+      },
+      required: ["channel_id"]
+    }
+  },
+  {
+    name: "slack_search_messages",
+    description: "Search messages across the Slack workspace",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Search query (supports Slack syntax like from:@user, in:#channel)"
+        },
+        count: {
+          type: "number",
+          description: "Number of results (max 100, default 20)"
+        }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "slack_users_info",
+    description: "Get detailed information about a Slack user",
+    inputSchema: {
+      type: "object",
+      properties: {
+        user_id: {
+          type: "string",
+          description: "Slack user ID"
+        }
+      },
+      required: ["user_id"]
+    }
+  },
+  {
+    name: "slack_send_message",
+    description: "Send a message to a channel or DM",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID to send to"
+        },
+        text: {
+          type: "string",
+          description: "Message text (supports Slack markdown)"
+        },
+        thread_ts: {
+          type: "string",
+          description: "Thread timestamp to reply to (optional)"
+        }
+      },
+      required: ["channel_id", "text"]
+    }
+  },
+  {
+    name: "slack_get_thread",
+    description: "Get all replies in a message thread",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channel_id: {
+          type: "string",
+          description: "Channel or DM ID"
+        },
+        thread_ts: {
+          type: "string",
+          description: "Thread parent message timestamp"
+        }
+      },
+      required: ["channel_id", "thread_ts"]
+    }
+  },
+  {
+    name: "slack_list_users",
+    description: "List all users in the workspace",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Maximum users to return (default 100)"
+        }
+      }
+    }
+  }
+];

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@jtalk22/slack-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Slack - Access DMs, channels, and messages from Claude",
+  "type": "module",
+  "main": "src/server.js",
+  "bin": {
+    "slack-mcp-server": "./src/server.js",
+    "slack-mcp-web": "./src/web-server.js"
+  },
+  "scripts": {
+    "start": "node src/server.js",
+    "web": "node src/web-server.js",
+    "tokens:status": "node scripts/token-cli.js status",
+    "tokens:refresh": "node scripts/token-cli.js refresh",
+    "tokens:auto": "node scripts/token-cli.js auto",
+    "tokens:clear": "node scripts/token-cli.js clear"
+  },
+  "keywords": [
+    "mcp",
+    "slack",
+    "claude",
+    "anthropic",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "chatbot",
+    "claude-desktop",
+    "claude-code",
+    "slack-api",
+    "slack-bot",
+    "dm",
+    "direct-messages",
+    "workspace",
+    "automation"
+  ],
+  "funding": {
+    "type": "individual",
+    "url": "https://github.com/sponsors/jtalk22"
+  },
+  "author": "jtalk22",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jtalk22/slack-mcp-server.git"
+  },
+  "homepage": "https://github.com/jtalk22/slack-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/jtalk22/slack-mcp-server/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "express": "^4.18.2"
+  },
+  "files": [
+    "src/",
+    "lib/",
+    "public/",
+    "scripts/",
+    "docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "playwright": "^1.57.0"
+  }
+}