---
title: "Hjarni integration for LuumenAI"
url: "https://www.luumen.ai/integrations/hjarni/"
entity: SoftwareIntegration
category: "Knowledge & documentation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Hjarni integration for LuumenAI

Search, link, and maintain your Hjarni notes from the terminal

## What LuumenAI can do with Hjarni

LuumenAI connects to Hjarni with an API token and exposes 15 tools (6 read-only · 8 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 15 tools (6 read-only · 8 write · 1 destructive)
- Plan: available on all plans
- Category: Knowledge & documentation

## About Hjarni with LuumenAI

Connect Hjarni and your notes become working context. Luumen reads containers, tags, trashed items, and full Markdown bodies on request, so you can find the runbook you half-remember without leaving the terminal. Changes — new notes, retags, moves, restores — are previewed and approved before they land. Luumen connects with an API key.

## Example tools

Read-only (6 in total):

- `HJARNI_GET_ACCOUNT_STATUS` — Return the connected Hjarni identity, token scope, plan, teams, and current resource usage and quotas.
- `HJARNI_GET_NOTE` — Get one Hjarni note by ID with its Markdown body, tags, container, attachments, links, and optimistic-lock version.
- `HJARNI_LIST_CONTAINERS` — List Hjarni containers as active roots, archived roots, or all active containers in a flat view.
- `HJARNI_LIST_NOTES` — List and filter personal Hjarni notes, including active, inbox, archived, or favorited notes.
- `HJARNI_LIST_TAGS` — List all Hjarni tags and their note counts.
- `HJARNI_LIST_TRASHED_NOTES` — List recoverable trashed Hjarni notes with their deletion and scheduled purge times.

Write and destructive (9 in total, approval required by default):

- `HJARNI_CREATE_CONTAINER` — Create a root or nested Hjarni container for organizing notes.
- `HJARNI_CREATE_NOTE` — Create a Markdown note in the inbox or a container.
- `HJARNI_CREATE_NOTES` — Create 1-25 Markdown notes in order and return one result per input.
- `HJARNI_CREATE_TAG` — Create a Hjarni tag for organizing notes.
- `HJARNI_RENAME_TAG` — Rename an existing Hjarni tag without changing its note associations.
- `HJARNI_RESTORE_NOTE` — Restore a note from Trash before its scheduled purge and return the active note.
- `HJARNI_TRASH_NOTE` — Move a note to recoverable Trash.
- `HJARNI_UPDATE_CONTAINER` — Update a Hjarni container's name, description, parent, position, or container-specific AI instructions.

## Frequently asked questions

### How does LuumenAI connect to Hjarni?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Hjarni on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Hjarni — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/hjarni/