# Money Forward

```json
{
  "name": "Money Forward",
  "slug": "money_forward",
  "url": "https://composio.dev/toolkits/money_forward",
  "markdown_url": "https://composio.dev/toolkits/money_forward.md",
  "logo_url": "https://logos.composio.dev/api/money_forward",
  "categories": [
    "finance & accounting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-06T07:04:47.520Z"
}
```

![Money Forward logo](https://logos.composio.dev/api/money_forward)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Money Forward MCP or direct API to access tenant details, manage accounting offices, query journals, and review financial reports through natural language.

## Summary

Money Forward is a business accounting service for managing financial data, journals, offices, and trade partners.
It gives businesses a centralized view of accounting records and financial reports.

## Categories

- finance & accounting

## Toolkit Details

- Tools: 23

## Images

- Logo: https://logos.composio.dev/api/money_forward

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Money Forward.
  - Setup:
    - Configure Oauth2 credentials for Money Forward.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List Money Forward accounting offices
- Review Money Forward journal entries this month
- Summarize Money Forward financial reports

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MONEY_FORWARD_CREATE_JOURNAL` | Create Journal | Create and persist an accounting journal with one to 300 debit and credit lines. This action changes the connected Cloud Accounting ledger. On create, Money Forward appends a newline and the OAuth application name to memo; leave room within the 200-character input limit and trust the returned memo as the persisted value. |
| `MONEY_FORWARD_CREATE_TRADE_PARTNERS` | Create Trade Partners | Create and persist one or more Cloud Accounting trade-partner master records in one batch. A successful call has a persistent side effect; the approved API surface provides no operation to update or delete these records. |
| `MONEY_FORWARD_CREATE_TRANSACTIONS` | Create Transactions | Create and persist a batch of one to 1,000 manual transactions under one Money Forward connected service. New transactions can take a short time to appear in filtered transaction lists. |
| `MONEY_FORWARD_CREATE_VOUCHERS` | Create Vouchers | Persist one to five base64-encoded voucher files in Money Forward Cloud Accounting and optionally attach them to a journal. A successful call stores the uploaded evidence; the documented vouchers API can detach a voucher from a journal but does not provide an operation to delete the stored file. |
| `MONEY_FORWARD_DELETE_JOURNAL` | Delete Journal | Permanently delete one Money Forward Cloud Accounting journal by ID. Back up the journal before deletion; if it is linked to a transaction, that transaction becomes excluded. |
| `MONEY_FORWARD_DETACH_VOUCHER_FROM_JOURNAL` | Detach Voucher From Journal | Remove the association between one Money Forward voucher and one journal. This irreversible update does not delete the stored voucher file. |
| `MONEY_FORWARD_GET_ACCOUNT_BALANCE_TRENDS` | Get Account Balance Trends | Return monthly balance-sheet or profit-and-loss trends for a fiscal period; the report excludes unrealized journals and aggregates all departments. |
| `MONEY_FORWARD_GET_JOURNAL` | Get Journal | Return one accounting journal by its journal ID, including debit and credit branches and attached voucher IDs. |
| `MONEY_FORWARD_GET_OFFICE` | Get Accounting Office | Return the connected Cloud Accounting office and its accounting periods; fails if the tenant is not registered for Cloud Accounting. |
| `MONEY_FORWARD_GET_TENANT` | Get Tenant | Return the code and name of the Money Forward business tenant authorized by the connected account. |
| `MONEY_FORWARD_GET_TRIAL_BALANCE` | Get Trial Balance | Return a balance-sheet or profit-and-loss trial balance for a fiscal period; the report excludes unrealized journals and aggregates all departments. |
| `MONEY_FORWARD_JOURNALIZE_TRANSACTION` | Journalize Transaction | Create and persist a journal from one Money Forward transaction using the supplied account classification. This compound operation also irreversibly changes the source transaction's journalizing state. |
| `MONEY_FORWARD_LIST_ACCESSIBLE_OFFICES` | List Accessible Accounting Offices | List every Cloud Accounting office available to the current authorization; offices that cannot use Cloud Accounting are excluded. |
| `MONEY_FORWARD_LIST_ACCOUNTS` | List Accounts | List Cloud Accounting chart-of-account entries and their IDs for use in journals and reports. |
| `MONEY_FORWARD_LIST_CONNECTED_ACCOUNTS` | List Connected Accounts | List external financial services connected to the current Cloud Accounting office, including manual status and linked account and sub-account IDs. |
| `MONEY_FORWARD_LIST_DEPARTMENTS` | List Departments | List Cloud Accounting departments and their IDs for interpreting or constructing journal lines. |
| `MONEY_FORWARD_LIST_JOURNALS` | List Journals | Return one page of accounting journals for a transaction-date period, requiring at least a start or end date. Optionally filter by account, transaction IDs, or realization status; use the returned total_pages to continue through results. |
| `MONEY_FORWARD_LIST_SUB_ACCOUNTS` | List Sub-Accounts | List Cloud Accounting sub-accounts, optionally limited to one parent account, and return their IDs and tax mappings. |
| `MONEY_FORWARD_LIST_TAXES` | List Tax Categories | List Cloud Accounting tax categories, rates, availability, and IDs used on journal lines. |
| `MONEY_FORWARD_LIST_TERM_SETTINGS` | List Term Settings | Return all accounting-year settings for the connected Cloud Accounting office, ordered by descending start date. |
| `MONEY_FORWARD_LIST_TRADE_PARTNERS` | List Trade Partners | List Cloud Accounting trade partners and their codes, registration numbers, and availability for use on journal lines. |
| `MONEY_FORWARD_LIST_TRANSACTIONS` | List Transactions | Return one page of collected transaction details for an inclusive date range no more than 366 days apart, with connected-account, amount, text, journalization-status, and ordering filters. Use page and returned total_pages to continue; newly created transactions can take a short time to appear in filtered lists. |
| `MONEY_FORWARD_UPDATE_JOURNAL` | Update Journal | Replace an existing accounting journal's writable fields. This is a full replacement: writable fields omitted from the journal body are overwritten rather than preserved. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Money Forward
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["money_forward"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["money_forward"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Money Forward tools with your agent

Send a request, execute the Money Forward tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "List the Money Forward accounting offices and summarize this month's journal entries."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List the Money Forward accounting offices and summarize this month's journal entries." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Money Forward and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["money_forward"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["money_forward"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Money Forward request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Money Forward tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("List the Money Forward accounting offices and summarize this month's journal entries.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List the Money Forward accounting offices and summarize this month's journal entries.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Money Forward Integration

- Supports both Money Forward MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Money Forward data

### 2. Managed Auth

- Connect your own Money Forward OAuth credentials securely
- Central place to manage, scope, and revoke Money Forward access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Money Forward
- Scoped, least privilege access to Money Forward resources
- Full audit trail of agent actions to support review and compliance

## Use Money Forward with any AI Agent Framework

Choose a framework you want to connect Money Forward with:

- [ChatGPT](https://composio.dev/toolkits/money_forward/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/money_forward/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/money_forward/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/money_forward/framework/atomic-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [bexio](https://composio.dev/toolkits/bexio) - bexio is a Swiss business management platform for accounting, invoicing, contacts, projects, banking, expenses, and payroll. It brings core business operations into one connected workspace.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Cashfree](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clarity AI MCP](https://composio.dev/toolkits/clarity_ai_mcp) - Clarity AI MCP is an MCP toolkit for simulating SFDR 2.0 fund classifications from a fund name, ISIN, or CUSIP. Use it to tap Clarity AI disclosure data and modeling without building custom sustainability-data workflows.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinbase Agents MCP](https://composio.dev/toolkits/coinbase_agents_mcp) - Coinbase Agents MCP is Coinbase's managed toolkit exposing accounts, portfolios, orders, fills, and market data. Use it to let authorized agents inspect holdings, execute trades, perform transfers, and handle payments.
- [Coinbase Wallet MCP](https://composio.dev/toolkits/coinbase_wallet_mcp) - Coinbase Wallet MCP is Coinbase's wallet service for interacting with onchain accounts. Use it to give agents secure, structured access to inspect wallets and request onchain actions.
- [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place.

## Frequently Asked Questions

### Do I need my own developer credentials to use Money Forward with Composio?

Yes, Money Forward requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)