maesn-mcp

maesndev/maesn-mcp

3.2

If you are the rightful owner of maesn-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Maesn MCP Server is a robust platform designed to facilitate seamless integration with Maesn's unified backend API, enabling efficient retrieval of accounting data.

Tools
4
Resources
0
Prompts
0

Maesn Mcp Server

Maesn's official MCP (Model Context Protocol) server built with Nx, designed to connect to Maesn’s unified backend API. This server enables tools to retrieve accounting data like customers, invoices, bills, and accounts through structured, authenticated requests.

🚀 Features

  • ⚡ Fast, scalable Nx + TypeScript setup
  • 🧰 Pre-integrated with Maesn’s Unified API via MCP
  • 🧪 Ready-to-use tools: customers, invoices, bills, accounts

📦 Installation

git clone https://github.com/YOUR_ORG/maesn-mcp.git
cd maesn-mcp
npm install

⚙️ Setup

Prerequisites

Before running the Maesn MCP server locally, ensure you have the following:

  • 🔐 A Maesn API key
    You can create an account and generate your API key via the Maesn Developer Portal.

  • 🧱 Node.js (v16 or later)
    We recommend using Node.js v20+ for best compatibility. Download it from nodejs.org.

  • 🧰 Nx CLI (optional but helpful)
    Nx is used to manage and run the workspace. Install it globally for easier use:

    npm install -g nx

MCP Configuration (e.g. Claude integration)

To connect your Maesn MCP server to an MCP-compatible environment (like Claude Desktop), download and install Claude, then follow these steps:

  1. Locate the configuration file on your machine. For Claude Desktop, this is typically:
  • Windows: %APPDATA%/Claude/claude_desktop_configuration.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_configuration.json
  • Linux: ~/.config/Claude/claude_desktop_configuration.json
  1. Add the following entry to the mcpServers section of the file:
{
  "mcpServers": {
    "maesn-mcp": {
      "command": "node",
      "args": [
        "<ABSOLUTE_PATH>/apps/maesn-mcp/dist/main.js"
      ]
    }
  }
}

🔁 Replace <ABSOLUTE_PATH> with the full local path to your built MCP server.

Environment Variable Configuration

You can configure your Maesn API credentials using environment variables. When set, these values are automatically used by the agent, so you do not need to pass them manually each time.

You can still override the environment values at runtime by instructing your LLM to use a different API key or account key. This is useful if you want to switch between credentials quickly.

{
  "mcpServers": {
    "maesn-mcp": {
      "command": "node",
      "args": [
        "<ABSOLUTE_PATH>/apps/maesn-mcp/dist/main.js"
      ],
      "env": {
        "API_KEY": "your_maesn_api_key",
        "ACCOUNT_KEY": "your_maesn_account_key"
      }
    }
  }
}

⚠️ Important: On Windows, Claude Desktop may fail to inject environment variables correctly. If this happens, skip the environment configuration and provide the API key and account key directly in your request to Claude.

🛠 Run Locally

After cloning the project, install dependencies:

npm install

Then start the dev server:

npx nx serve maesn-mcp

Available Resources

The MCP server is still under development, but most resources supported in the Unified API are already fully available through our MCP. Below is the list of currently supported resources:

  • Accounts
  • Async tasks
  • Bills
  • Booking proposals
  • Contacts
  • Customers
  • Dimensions
  • Expenses
  • Goods receipts
  • Invoices
  • Items
  • Journal entries
  • Journals
  • Offers
  • Payments
  • Payment terms
  • Projects
  • Purchase orders
  • Sales orders
  • Suppliers
  • Tax rates
  • Units
  • Vendor credits

⚠️ Note: File support is not yet available. Additional resources and tools will be added incrementally.

📬 Contact Us

Have questions, need help, or want to explore what Maesn can do for you? We're here to help.

🌐 Learn More

🤝 Get in Touch