czottmann/kagi-ken-mcp

A lightweight Node MCP server around the kagi-ken package, providing access to Kagi.com services using Kagi session tokens:
- **Search**: Searches Kagi
- **Summarizer**: Uses Kagi's Summarizer to create summaries from URLs or text content
Unlike the official Kagi API which requires API access, this MCP server uses your existing Kagi session to access both search and summarization features.
_"Kagi-ken"_ is a portmanteau of _"Kagi"_ (the service) and _"token"_.
Why?
The Kagi API requires a separate API key, which are invite-only at the moment. If you already have a Kagi subscription but no API access, yet want to programmatically access Kagi's services from LLMs or agents like Claude, this MCP server provides an alternative.
Features
- **Search**: Fetch web results using Kagi Search with concurrent query processing
- **Summarization**: Summarize content from URLs with customizable output types and languages
The server supports two methods for using your Kagi session token (see Installation), in this order:
1. KAGI_SESSION_TOKEN environment variable
2. ~/.kagi_session_token file containing the token string
It includes comprehensive error handling:
- Connection timeouts (10 seconds per search)
- Invalid input validation
- Environment variable validation
- Graceful error formatting
Installation
Node.js 22+ is required.
1. Get Kagi Session Token
1. Visit Kagi Settings in your browser
2. Copy the **Session Link**
3. Extract the token value from the link
4. Use that value as your session token: save to ~/.kagi_session_token (recommended), alternatively pass as KAGI_SESSION_TOKEN env variable
The server will automatically try the environment variable first, then fall back to the token file.
> [!WARNING]
> **Security Note**: Keep your session token private. It provides access to your Kagi account.
2.a. Add MCP server to Claude Desktop
Add kagi-ken-mcp to your claude_desktop_config.json which you can open from the Claude Desktop app via Settings → Developer → Local MCP Servers → Edit Config.
Option 1: Using token file (recommended)
Option 2: Using environment variable
Post-install
Disable Claude Desktop's built-in websearch so it'll use this here MCP server. And maybe add this to your "Personal preferences" (i.e., system prompt) in Settings:
2.b. Add MCP server to Claude Code
Option 1: Using token file (recommended)
Option 2: Using environment variable
Post-install
Disable Claude Code's built-in web search (optional) by setting the permission in the relevant .claude/settings*.json file:
Usage: Pose query that requires use of a tool
e.g. _"Who was time's 2024 person of the year?"_ for search, or "summarize this video: https://www.youtube.com/watch?v=sczwaYyaevY" for summarizer.
Tools
kagi_search_fetch
Fetch web results based on one or more queries using the Kagi Search API. Results are numbered continuously for easy reference.
**Parameters:**
- queries (array of strings): One or more search queries