Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@chatlab-mcp list my recent chat sessions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server that connects ChatLab to AI assistants (Claude Desktop, Cursor, custom agents). Query your local chat history with natural language.
Tracks ChatLab v0.19.0
ChatLab installed and running
API enabled in ChatLab Settings → API, with a token generated
Node.js 18+
Related MCP server: Shepherd MCP
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"
}
}
}
}git clone https://github.com/gamesme/chatlab-mcp
cd chatlab-mcp
npm install && npm run buildEdit ~/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.
Tool | Description |
| List all imported chat sessions with name, platform, and message count |
| Get details of a single session by ID |
| Retrieve messages with filters: keyword, time range, sender, pagination (max 100/call) |
| List all members in a session with their platformId and message count |
| Statistical overview: message counts, member activity, type distribution, time range |
| Run aggregation queries (COUNT/GROUP BY) against the session database |
Tool | Description |
| N messages before/after one or more target message IDs |
| Interleaved messages between two specific members (numeric IDs) |
| AI-generated chat sub-session summaries (from the chat_session table) |
| FTS5 keyword search with surrounding context window |
| Hourly / weekday / daily distribution, timezone-aware |
| Top-N members by message count with percentage of total |
| Historical account name / nickname entries for a member |
| Reply intervals between sender pairs (LAG window function) |
| Stub — returns guidance (NLP segmentation not bundled in MCP) |
get_messages returns at most 100 messages per call. Use the page parameter to paginate. Responses include has_more and a hint when more results exist.
execute_sql is for statistical aggregation only. Use get_messages or get_message_context to read message content.
Analytics tools issue their own SQL through the same /sql endpoint (no 200-row LIMIT injection).
All avatar/binary fields are stripped from responses to minimize context usage.
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.jsCHATLAB_URL defaults to http://127.0.0.1:5200.
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/Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
AI access to Hitsteps analytics, live visitors, uptime, goals, alerts, and chats.
Persistent memory for AI agents. Search, store, and recall across sessions.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gamesme/chatlab-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server