# Osome MCP server

## What Osome is

Osome is an AI-enabled accounting and corporate services provider for small businesses. It handles company incorporation, bookkeeping, tax filing, payroll and corporate secretary work through a web and mobile app backed by in-house accountants. Osome serves businesses in Singapore, Hong Kong, the United Kingdom and the UAE.

Website: https://osome.com

## Endpoint

```text
https://mcp.osome.com/mcp
```

This is the only public endpoint. Do not use other paths on mcp.osome.com.

## Transport

Streamable HTTP

## Authentication

OAuth 2.1 with PKCE. The user signs in with their Osome account in a browser window and approves the connection. No API keys.

Authorization server metadata: https://mcp.osome.com/.well-known/oauth-authorization-server

Issuer: https://mcp.osome.com

Tokens are scoped to the signed-in user and can be revoked by disconnecting the server in the AI client.

## Scopes

company:documents:write (needed by write tools). The full list is in scopes_supported in the authorization server metadata.

## Capabilities

The server has read tools and write tools. Write tools carry MCP write annotations and are throttled. Confirm with the user before calling a write tool, because some send data to third parties (for example, submit-invoice sends the invoice to the customer).

- Companies, read: list-companies, get-company, get-corporate-subsidiaries, get-directors-shareholders
- Transactions, read: search-transactions, get-transaction-conversation, get-journal-entries, get-bank-accounts, get-chart-of-accounts, list-transaction-cashcoding-recommendations
- Transactions, write: add-transaction-comment, apply-transaction-cashcoding-recommendation
- Documents, read: list-documents, get-document
- Documents, write: prepare-document-upload, complete-document-upload
- Reports, read: get-balance-sheet, get-profit-and-loss, get-profit-and-loss-v2, get-cash-flow-statement, get-trial-balance, get-aged-payables, get-aged-receivables, get-aged-receivables-v2, get-overdue-invoices, get-invoice-pending-summary, get-revenue-summary
- Invoices, read: list-invoices, preview-invoice, get-invoice-document-links
- Invoices, write: create-invoice-draft, update-invoice-draft, submit-invoice, generate-invoice-pdf, duplicate-invoice
- Credit notes, read: get-credit-note
- Credit notes, write: create-credit-note, submit-credit-note

Total: 38 tools.

## Limits

- Available to Osome clients with a my.osome.com login.
- The assistant only sees companies the signed-in user can access.
- Document uploads: max 50 MB per file. Three-step flow: prepare-document-upload returns a presigned upload target and a single-use, short-lived uploadToken; the client uploads the bytes directly to Osome storage; complete-document-upload creates the document. File bytes never pass through MCP.
- search-transactions returns 50 results by default, newest first.
- Write tools are rate-limited. If a call is refused, wait and retry.
- Osome does not store the assistant's queries.

## Setup

### Claude

Web and desktop:

1. Open Settings, then Connectors.
2. Choose Add custom connector.
3. Name: Osome. URL: https://mcp.osome.com/mcp
4. Click Connect, sign in to Osome in the browser window and approve.

### ChatGPT

Developer mode:

1. Turn on developer mode in Settings, under Apps and Connectors, Advanced.
2. Create a connector with URL https://mcp.osome.com/mcp and authentication set to OAuth.
3. Sign in to Osome in the browser window and approve.

### Claude Code

```bash
claude mcp add --transport http osome https://mcp.osome.com/mcp
```

Then run /mcp inside Claude Code and authenticate in the browser.

### Cursor

Add to ~/.cursor/mcp.json:

```json
{
  "mcpServers": {
    "osome": {
      "url": "https://mcp.osome.com/mcp"
    }
  }
}
```

Restart Cursor. Sign in when prompted.

### VS Code

Add to .vscode/mcp.json in the workspace:

```json
{
  "servers": {
    "osome": {
      "type": "http",
      "url": "https://mcp.osome.com/mcp"
    }
  }
}
```

Start the server from the file. Sign in when prompted.

## Last verified

Not yet verified.