Moss MCP Server

MCP server for the Moss Public API.

This package is published as moss-mcp-server.

What This Server Provides

Read-only Moss tools for:

• Expenses
• Users
• Suppliers
• Expense accounts
• Dimensions
• Dimension items
• Tax rates

For Users (Install from Package)

If you just want to use the MCP server in Claude Desktop, use this option.

Claude Desktop config

{
  "mcpServers": {
    "moss": {
      "command": "npx",
      "args": [
        "-y",
        "moss-mcp-server"
      ],
      "env": {
        "MOSS_CLIENT_ID": "kid_your_key",
        "MOSS_CLIENT_SECRET": "sk_your_secret"
      }
    }
  }
}

Then fully quit and reopen Claude Desktop.

You do not need to clone this repo for package mode.

For Maintainers (Publish New Versions)

Use these steps when releasing updates to npm.

1. Build and verify

cd /path/to/moss-mcp-server
npm install
npm run build
npm pack

2. Bump version

Update version in package.json (for example 1.0.0 -> 1.0.1).

3. Publish

npm login
npm whoami
npm publish

After publish, users keep the same Claude config (npx -y moss-mcp-server) and will get the latest version.

Optional: Local Repo Mode

If you prefer running from a local clone:

cd /path/to/moss-mcp-server
npm install
npm run build

Claude config for local clone:

{
  "mcpServers": {
    "moss": {
      "command": "node",
      "args": ["/path/to/moss-mcp-server/dist/index.js"],
      "env": {
        "MOSS_CLIENT_ID": "kid_your_key",
        "MOSS_CLIENT_SECRET": "sk_your_secret"
      }
    }
  }
}

Environment Variables

Required:

• MOSS_CLIENT_ID
• MOSS_CLIENT_SECRET

Optional:

• MOSS_API_BASE_URL (default: https://public-api.getmoss.com)
• TRANSPORT (stdio by default)
• PORT (used only when TRANSPORT=http)

Quick Troubleshooting

• No tools in Claude: fully restart Claude Desktop.
• Auth errors: verify MOSS_CLIENT_ID and MOSS_CLIENT_SECRET.
• Package mode not starting: make sure Node.js is installed.
• Local mode not starting: run npm run build again.

API Docs

• Overview: https://developers.getmoss.com/
• Data model: https://developers.getmoss.com/data-model
• API reference start: https://developers.getmoss.com/api/get-expenses