Documentation

Ogarni.AI Documentation

Welcome to the Ogarni.AI developer documentation. Here you will find everything you need to access your personal finance data programmatically.

What’s available

API

The Ogarni.AI REST API provides read-only access to your receipts, spending summaries, categories, notifications, and more. Authenticate with a personal API token and start querying over 20 endpoints.

• Base URL: https://api.ogarni.ai
• Auth: X-API-Key header with an oai_ prefixed token
• Format: JSON responses

Get started with the API

MCP Server

The Model Context Protocol (MCP) server lets LLMs like Claude interact with your Ogarni.AI data directly. It exposes 20 read-only tools that wrap every available API endpoint.

Learn about the MCP server

Claude Skill

A Claude skill is included in the repository that teaches Claude how to work with the Ogarni.AI API. It covers authentication, endpoints, rate limits, and code examples — no manual setup required.

Learn about the Claude skill

Quick links

Topic	Description
Quick start	Create a token and make your first API call in minutes
API tokens	Token creation, scopes, and security best practices
Endpoints	Full reference for all available API endpoints
Errors and rate limits	Error format, status codes, and rate limit details
Code examples	Ready-to-use examples in curl, Python, and JavaScript
MCP server	Overview and available tools
MCP installation	Setup for Claude Code, Claude Desktop, Cursor, and Windsurf
Claude skill	Auto-loaded skill for the Ogarni.AI API