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

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

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:

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

Restart Cursor. Sign in when prompted.

VS Code

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

{
  "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.