How do I use Ogarni.AI MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Ogarni.AI MCP Server show me my latest receipts" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Ogarni.AI MCP Server

by IsidoreSoftware

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Ogarni.AI MCP Server

MCP server for read-only access to Ogarni.AI personal finance data.

Setup

1. Get an API Token

Download the Ogarni.AI mobile app:
- iOS (App Store)
- Android (Google Play - Beta)
Open the app and go to Settings → API Tokens
Create a new token with read scope
Copy the token (starts with oai_)

2. Install

Claude Code

claude mcp add ogarniai-mcp-server -e OGARNIAI_API_TOKEN=oai_your_token -- npx -y github:IsidoreSoftware/ogarniai-mcp-server

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ogarniai": {
      "command": "npx",
      "args": ["-y", "github:IsidoreSoftware/ogarniai-mcp-server"],
      "env": {
        "OGARNIAI_API_TOKEN": "oai_your_token_here"
      }
    }
  }
}

Important: After adding the config, restart Claude Desktop completely for changes to take effect.

Cursor

Add to .cursorrules or MCP settings:

{
  "mcpServers": {
    "ogarniai": {
      "command": "npx",
      "args": ["-y", "github:IsidoreSoftware/ogarniai-mcp-server"],
      "env": {
        "OGARNIAI_API_TOKEN": "oai_your_token_here"
      }
    }
  }
}

Windsurf

Add to Windsurf MCP config (Settings → MCP):

{
  "mcpServers": {
    "ogarniai": {
      "command": "npx",
      "args": ["-y", "github:IsidoreSoftware/ogarniai-mcp-server"],
      "env": {
        "OGARNIAI_API_TOKEN": "oai_your_token_here"
      }
    }
  }
}

Local Development

git clone https://github.com/IsidoreSoftware/ogarniai-mcp-server.git
cd ogarniai-mcp-server
npm install
npm run build
OGARNIAI_API_TOKEN=oai_your_token node dist/index.js

Related MCP server: ZenMoney MCP

Available Tools

Tool	Description
`ogarniai_list_documents`	List receipts with date filters and sorting
`ogarniai_get_document`	Get single receipt details
`ogarniai_get_document_image`	Get receipt image
`ogarniai_get_document_duplicates`	Get duplicate suggestions for a document
`ogarniai_list_categories`	List expense/income categories
`ogarniai_list_tags`	List user tags
`ogarniai_get_weekly_summary`	Get latest weekly summary
`ogarniai_get_weekly_summary_periods`	List available summary periods
`ogarniai_get_summary_by_period`	Get summary for a custom date range
`ogarniai_get_current_period`	Get summary for a preset period
`ogarniai_list_notifications`	List notifications with filters
`ogarniai_get_notification`	Get notification details
`ogarniai_get_unread_count`	Get unread notification count
`ogarniai_list_groups`	List finance groups
`ogarniai_get_group`	Get group details
`ogarniai_list_mailboxes`	List inbound email addresses
`ogarniai_list_dedup_suggestions`	List duplicate suggestions
`ogarniai_list_loyalty_accounts`	List loyalty program accounts
`ogarniai_list_supported_banks`	List supported banks
`ogarniai_get_recurring_expenses`	List recurring expenses

Configuration

Environment Variable	Required	Default	Description
`OGARNIAI_API_TOKEN`	Yes	-	API token (starts with `oai_`)
`OGARNIAI_API_URL`	No	`https://api.ogarni.ai`	API base URL

Security

All tools are read-only
Token is passed via environment variable, never hardcoded
Input validated with Zod schemas
Error messages never expose token values

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/IsidoreSoftware/ogarniai-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server