About Chatlab MCP Server
Chatlab MCP Server is an MCP server published by gamesme in the Developer Tools category: mCP server for ChatLab chat history.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add chatlab-mcp-server -- npx -y @gamesme/chatlab-mcp-servernpx -y @gamesme/chatlab-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
execute_sqlRun aggregation queries (COUNT/GROUP BY) against the session database
Parameters not published.
get_membersList all members in a session with their platformId and message count
Parameters not published.
get_messagesRetrieve messages with filters: keyword, time range, sender, pagination (max 100/call)
Parameters not published.
get_sessionGet details of a single session by ID
Parameters not published.
get_stats_overviewStatistical overview: message counts, member activity, type distribution, time range
Parameters not published.
list_sessionsList all imported chat sessions with name, platform, and message count
Parameters not published.
Ask AI
Ask AI about Chatlab MCP Server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
chatlab-mcp
MCP server that connects ChatLab to AI assistants (Claude Desktop, Cursor, custom agents). Query your local chat history with natural language.
Tracks ChatLab v0.17.2
Requirements
- ChatLab installed and running
- API enabled in ChatLab Settings → API, with a token generated
- Node.js 18+
Installation
npx (recommended)
No installation needed. Configure your AI client directly:
{
"mcpServers": {
"chatlab": {
"command": "npx",
"args": ["-y", "chatlab-mcp"],
"env": {
"CHATLAB_TOKEN": "clb_xxxxxxxxxxxx",
"CHATLAB_URL": "http://127.0.0.1:5200"
}
}
}
}
From source
git clone https://github.com/gamesme/chatlab-mcp
cd chatlab-mcp
npm install && npm run build
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
With npx:
{
"mcpServers": {
"chatlab": {
"command": "npx",
"args": ["-y", "chatlab-mcp"],
"env": {
"CHATLAB_TOKEN": "clb_xxxxxxxxxxxx",
"CHATLAB_URL": "http://127.0.0.1:5200"
}
}
}
}
From source (use your Homebrew node to avoid version issues):
{
"mcpServers": {
"chatlab": {
"command": "/opt/homebrew/bin/node",
"args": ["/absolute/path/to/chatlab-mcp/dist/index.js"],
"env": {
"CHATLAB_TOKEN": "clb_xxxxxxxxxxxx",
"CHATLAB_URL": "http://127.0.0.1:5200"
}
}
}
}
Restart Claude Desktop after saving. The chatlab tools will appear in the tools list.
Tools
| Tool | Description |
|---|---|
list_sessions |
List all imported chat sessions with name, platform, and message count |
get_session |
Get details of a single session by ID |
get_messages |
Retrieve messages with filters: keyword, time range, sender, pagination (max 100/call) |
get_members |
List all members in a session with their platformId and message count |
get_stats_overview |
Statistical overview: message counts, member activity, type distribution, time range |
execute_sql |
Run aggregation queries (COUNT/GROUP BY) against the session database |
Notes
get_messagesreturns at most 100 messages per call. Use thepageparameter to paginate. Responses includehas_moreand ahintwhen more results exist.execute_sqlis for statistical aggregation only (word frequency, activity breakdown, member interactions). Useget_messagesto read message content.- All avatar/binary fields are stripped from responses to minimize context usage.
CLI Options
node dist/index.js --token <token> --url <url>
# or via env vars
CHATLAB_TOKEN=clb_xxx CHATLAB_URL=http://127.0.0.1:5200 node dist/index.js
CHATLAB_URL defaults to http://127.0.0.1:5200.
Development
npm test # run all tests
npm run test:watch # watch mode
npm run dev # run with ts-node (no build step)
npm run build # compile TypeScript → dist/
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.