Skip to content
KiomonDocs

Quickstart

import { Steps, Tabs, TabItem } from ‘@astrojs/starlight/components’;

This guide gets you from zero to a connected agent in about five minutes. You’ll sign up, install the extension, save your first document, and wire Kiomon into your AI coding assistant.

1. Create your account

Section titled “1. Create your account”

Open the Kiomon dashboard and sign up with Google or GitHub.

Every new account starts with a 14-day Pro trial — no card required. You get full Pro features (auto-linking, unlimited connectors) and fall back to Free automatically when the trial ends.

1. Go to **app.kiomon.com** and sign in. 2. Kiomon creates a default workspace for you (you can rename or add more later — Free accounts get 2, Pro gets 20). 3. That's it. Your library is empty and ready.

2. Install the browser extension

Section titled “2. Install the browser extension”

The extension is how you save pages and highlights while you browse.

1. Visit the [Chrome Web Store listing](#) and click **Add to Browser**.
2. Open the **Extensions** menu and click the pin next to Kiomon to keep it in your toolbar.
3. Open the popup — since you're already signed in to the dashboard, the extension picks up your session automatically.


</TabItem>
<TabItem label="Firefox">


1. Visit the [Firefox Add-ons listing](#) and click **Add to Firefox**.
2. Pin the extension to your toolbar.
3. Open the popup — your dashboard session is picked up automatically.


</TabItem>

The extension can be pointed at a different environment (local dev server, dev API, or production) — see Browser Extension for details.

3. Save your first document

Section titled “3. Save your first document”
  1. Open any article or documentation page you care about.
  2. Click the Kiomon icon in your toolbar.
  3. (Optional) Add a quick note or comma-separated tags.
  4. Click Save.

The page is extracted into clean, readable content, tagged automatically, and indexed for search. The extension icon shows a green ✓ when the save succeeds.

Want to save just a quote or snippet instead? Select text on any page, right-click, and choose Save highlight to Kiomon.

4. Create an API key

Section titled “4. Create an API key”

Agents authenticate to Kiomon with an API key.

  1. Go to Settings → API Keys in the dashboard.
  2. Click Generate Key and copy the value — it’s shown only once.
  3. Treat it like a password. Free accounts can hold 1 key; Pro accounts up to 10.

5. Connect an agent

Section titled “5. Connect an agent”

The fastest way to test Kiomon is with an MCP-capable editor or desktop client.

1. Open **Cursor Settings** (⌘+, on Mac / Ctrl+, on Windows) → **Features** tab.
2. Scroll to **MCP** and click **+ Add New MCP Server**.
3. Set:
  - **Name:** `kiomon`
  - **Type:** `command`
  - **Command:** `npx -y @kiomon/mcp-server`
  - **Environment:** set `KIOMON_TOKEN` to your API key and `KIOMON_URL` to `https://api.kiomon.com`
4. Restart Cursor (or toggle the server) and check that the Kiomon tools appear.


</TabItem>
<TabItem label="Claude Desktop">


1. Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows).
2. Add the `kiomon` server to `mcpServers`:


```json
{
  "mcpServers": {
    "kiomon": {
      "command": "npx",
      "args": ["-y", "@kiomon/mcp-server"],
      "env": {
        "KIOMON_TOKEN": "your-key",
        "KIOMON_URL": "https://api.kiomon.com"
      }
    }
  }
}
```


3. Restart Claude Desktop.


</TabItem>

If your client supports MCP but isn’t listed, the generic pattern is the same:

Terminal window
KIOMON_TOKEN=<your-key> KIOMON_URL=https://api.kiomon.com npx -y @kiomon/mcp-server

6. Ask your agent

Section titled “6. Ask your agent”

With the MCP server connected, your agent can query your library. Try:

“Search my Kiomon library for what I saved about Cloudflare Workers and summarize the key points.”

Or after a focused reading session:

“Based on the Stripe docs I just saved, how would I create a checkout session?”

Anything your agent decides is worth remembering can be drafted as a memory — it shows up in your dashboard Review Inbox for approval and only becomes active once you approve it.

Next steps

Section titled “Next steps”