AI integration (MCP) setup guide

Connector URL

https://kichitto-api.smartrich.ai/mcp

You will be asked to sign in with Google. Use the same Google account as the Kichitto app (Apple-only accounts are not supported yet).

AI integration is available on every plan, including the free one. It runs on your own AI subscription and does not consume your Kichitto OCR quota.

Supported clients

• Claude (claude.ai / Claude Desktop / Claude Code) — verified end to end on a live connection
• ChatGPT (developer-mode connectors; deep research search / fetch supported)
• Gemini CLI (remote MCP with OAuth — please read the note below)

Claude (claude.ai / Claude Desktop)

1. Sign in to claude.ai → Settings → Connectors
2. Choose "Add custom connector" and paste the URL above
3. Sign in with Google and review the consent screen
4. Ask in chat: "What are my total expenses this fiscal year?"

Claude Desktop and Claude Code on the same account pick it up automatically.

ChatGPT

1. ChatGPT Settings → "Apps & connectors" → enable Developer mode under advanced settings
2. Add a connector, paste the URL above, and sign in with Google

Gemini CLI

Add the following to your project's .gemini/settings.json (or ~/.gemini/settings.json).

{
  "mcpServers": {
    "kichitto": {
      "httpUrl": "https://kichitto-api.smartrich.ai/mcp"
    }
  }
}

1. Start Gemini CLI and run /mcp auth kichitto to complete the Google sign-in
2. Run gemini mcp list and confirm kichitto shows as connected

A precise note: our connector is served over Streamable HTTP with OAuth 2.1 and dynamic client registration, which is the mechanism Gemini CLI supports. We have verified that Gemini CLI v0.53 picks up this connector from the config above; we have not yet run the full /mcp auth sign-in end to end ourselves. If it does not work for you, please contact support.
Separately, as of August 2026 we have not found an official way to add a custom MCP connector to the Gemini mobile or web app (gemini.google.com). Use the CLI for Gemini.

Things you can ask

• "Total FY2025 expenses by account category"
• "Find the receipt from XYZ Corp" (answers with a Drive link to the scanned image)
• "Reconcile this bank statement against my books and list what's missing"
• "Are there any duplicate entries?" / "Which expenses are missing a T-number?"
• "Add 1,100 yen at XYZ on 15 July as supplies" → the AI proposes → you confirm → it is booked
• "Check the client name and amount on invoice 2026-INV-001"

Four practical workflows

1. Reconciling bank and card statements

Paste the statement and ask it to reconcile against your books for the same period. You get a list of transactions with no matching entry, and you can follow up with "add these" — each write still goes through your confirmation.

2. Issued invoices vs booked income

"Which issued invoices are not yet booked as income?" It lines up your issued documents against the income rows in your ledger. Note that the ledger has no payment-date column, so this connector cannot tell you whether an invoice has actually been paid (withholding tax and transfer fees also mean the amounts frequently will not match). Its job is to lay out the evidence, not to decide.

3. Business/personal apportionment

"Book 50% of this 8,000 yen phone bill as business." The apportioned amount and your reasoning go into the memo. The ratio itself is a tax judgement — confirm it with your accountant.

4. Monthly and pre-filing checks

"Check my books for this fiscal year." It flags suspected duplicates, expenses missing a qualified-invoice number, odd account categories and inconsistent tax breakdowns, and gives you a per-category total.

How it is kept safe

• Data is read and written directly from your Drive and is not permanently stored on our servers (only a cache of at most 5 minutes, so a chain of questions in one conversation stays workable, plus the bookkeeping needed to confirm a write — see Privacy Policy §3b)
• The only write is adding a new entry. Existing records can never be modified or deleted.
• Every write goes through propose → your confirmation. The server validates tax amounts and totals; anything that fails cannot be booked.
• Rows added by AI carry [AI補記] in the memo field and can be deleted from the app at any time.
• You can disconnect at any time by removing the connector in your AI client.

If something goes wrong

• "No write permission": if you connected while the connector was read-only, remove it and connect again.
• Google sign-in fails: wait a few minutes and start over. The account must already have completed Google sign-in in the app.
• "No ledger sheet": finish the initial Google setup in the app first.

Contact

Questions? Reach us via support.