Kagi Ken MCP

1# kagi-ken-mcp
2 
3A lightweight Node MCP server around the [`kagi-ken` package](https://github.com/czottmann/kagi-ken), providing access to Kagi.com services using Kagi session tokens:
4 
5- **Search**: Searches Kagi
6- **Summarizer**: Uses Kagi's Summarizer to create summaries from URLs or text content
7 
8Unlike the official Kagi API which requires API access, this MCP server uses your existing Kagi session to access both search and summarization features.
9 
10_"Kagi-ken"_ is a portmanteau of _"Kagi"_ (the service) and _"token"_.
11 
12 
13## Why?
14 
15The [Kagi API](https://help.kagi.com/kagi/api/overview.html) 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.
16 
17 
18## Features
19 
20- **Search**: Fetch web results using Kagi Search with concurrent query processing
21- **Summarization**: Summarize content from URLs with customizable output types and languages
22 
23The server supports two methods for using your Kagi session token (see [Installation](#installation)), in this order:
24 
251. `KAGI_SESSION_TOKEN` environment variable
262. `~/.kagi_session_token` file containing the token string
27 
28It includes comprehensive error handling:
29 
30- Connection timeouts (10 seconds per search)
31- Invalid input validation
32- Environment variable validation  
33- Graceful error formatting
34 
35<a href="https://glama.ai/mcp/servers/@czottmann/kagi-ken-mcp">
36  <img width="380" height="200" src="https://glama.ai/mcp/servers/@czottmann/kagi-ken-mcp/badge" alt="kagi-kan-mcp MCP server" />
37</a>
38 
39 
40## Installation
41 
42Node.js 22+ is required.
43 
44### 1. Get Kagi Session Token
45 
461. Visit [Kagi Settings](https://kagi.com/settings/user_details) in your browser
472. Copy the **Session Link**
483. Extract the `token` value from the link
494. Use that value as your session token: save to `~/.kagi_session_token` (recommended), alternatively pass as `KAGI_SESSION_TOKEN` env variable
50 
51The server will automatically try the environment variable first, then fall back to the token file.
52 
53> [!WARNING]
54> **Security Note**: Keep your session token private. It provides access to your Kagi account.
55 
56### 2.a. Add MCP server to Claude Desktop
57 
58Add 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.
59 
60#### Option 1: Using token file (recommended)
61```json
62{
63  "mcpServers": {
64    "kagi-ken-mcp": {
65      "command": "npx",
66      "args": ["-y", "github:czottmann/kagi-ken-mcp"]
67    }
68  }
69}
70```
71 
72#### Option 2: Using environment variable
73```json
74{
75  "mcpServers": {
76    "kagi-ken-mcp": {
77      "command": "npx",
78      "args": ["-y", "github:czottmann/kagi-ken-mcp"],
79      "env": {
80        "KAGI_SESSION_TOKEN": "YOUR_SESSION_TOKEN_HERE"
81      }
82    }
83  }
84}
85```
86 
87#### Post-install
88 
89[Disable Claude Desktop's built-in websearch](assets/claude-desktop-disable-websearch.png) so it'll use this here MCP server. And maybe add this to your "Personal preferences" (i.e., system prompt) in Settings:
90 
91```
92For web searches, use kagi-ken-mcp MCP server's `kagi_search_fetch` tool.
93For summarizing a URL, use the kagi-ken-mcp MCP server's `kagi_summarizer` tool.
94```
95 
96### 2.b. Add MCP server to Claude Code
97 
98#### Option 1: Using token file (recommended)
99 
100```bash
101claude mcp add kagi-ken-mcp --scope user -- npx -y github:czottmann/kagi-ken-mcp
102```
103 
104#### Option 2: Using environment variable
105 
106```bash
107claude mcp add kagi-ken-mcp \
108  --scope user \
109  --env KAGI_SESSION_TOKEN="YOUR_SESSION_TOKEN_HERE" -- \
110  npx -y github:czottmann/kagi-ken-mcp
111```
112 
113#### Post-install
114 
115Disable Claude Code's built-in web search (optional) by setting the permission in the relevant `.claude/settings*.json` file:
116 
117```json
118{
119  "permissions": {
120    "deny": [
121      "WebSearch"
122    ],
123    "allow": [
124      "mcp__kagi-ken-mcp__kagi_search_fetch",
125      "mcp__kagi-ken-mcp__kagi_summarizer"
126    ]
127  }
128}
129```
130 
131 
132## Usage: Pose query that requires use of a tool
133 
134e.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.
135 
136 
137## Tools
138 
139### `kagi_search_fetch`
140Fetch web results based on one or more queries using the Kagi Search API. Results are numbered continuously for easy reference.
141 
142**Parameters:**
143- `queries` (array of strings): One or more search queries
144 
145### `kagi_summarizer` 
146Summarize content from URLs using the Kagi Summarizer API. Supports various document types including webpages, videos, and audio.
147 
148**Parameters:**
149- `url` (string): URL to summarize
150- `summary_type` (enum): `"summary"` for paragraph prose or `"takeaway"` for bullet points (default: `"summary"`)  
151- `target_language` (string, optional): Language code (e.g., `"EN"` for English, default: `"EN"`)
152 
153 
154## Development
155 
156### Project Structure
157```
158kagi-ken-mcp/
159├── src/
160│   ├── index.js              # Main server entry point
161│   ├── tools/
162│   │   ├── search.js         # Search tool implementation
163│   │   └── summarizer.js     # Summarizer tool implementation
164│   └── utils/
165│       └── formatting.js     # Utility functions
166├── package.json
167└── README.md
168```
169 
170### Installation
171 
1721. **Clone the repository:**
173   ```bash
174   git clone <repository-url>
175   cd kagi-ken-mcp
176   ```
177 
1782. **Install dependencies:**
179   ```bash
180   npm install
181   ```
182 
183### Running in Development Mode
184```bash
185npm run dev
186```
187 
188### Debugging
189 
190Use the MCP Inspector to debug:
191```bash
192npx @modelcontextprotocol/inspector node ./src/index.js
193```
194 
195Then access the inspector at `http://localhost:5173`. If using environment variables, add your `KAGI_SESSION_TOKEN` in the environment variables section of the inspector.
196 
197### Contributing
198 
1991. Fork the repository
2002. Create a feature branch
2013. Make your changes
2024. Test with the MCP Inspector
2035. Submit a pull request
204 
205 
206## Author
207 
208Carlo Zottmann, <carlo@zottmann.dev>, https://c.zottmann.dev, https://github.com/czottmann.
209 
210This project is neither affiliated with nor endorsed by Kagi. I'm just a very happy customer.
211 
212> [!TIP]
213> I make Shortcuts-related macOS & iOS productivity apps like [Actions For Obsidian](https://actions.work/actions-for-obsidian), [Browser Actions](https://actions.work/browser-actions) (which adds Shortcuts support for several major browsers), and [BarCuts](https://actions.work/barcuts) (a surprisingly useful contextual Shortcuts launcher). Check them out!
214 
215 
216## Related Projects
217 
218- [czottmann/kagi-ken](https://github.com/czottmann/kagi-ken) - Unofficial session token-based Kagi client, Node
219- [czottmann/kagi-ken-cli](https://github.com/czottmann/kagi-ken-cli) - Unofficial Node session token-based CLI tool, Node
220- [Official Kagi MCP Server](https://github.com/kagisearch/kagimcp) - Python
221- [Model Context Protocol](https://modelcontextprotocol.io/)
222