Xero MCP Server

आधिकारिक

अपने व्यवसाय के लेखांकन डेटा के साथ हमारे आधिकारिक MCP सर्वर का उपयोग करके इंटरैक्ट करें।

दस्तावेज़

Xero MCP सर्वर

यह Xero के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर कार्यान्वयन है। यह MCP प्रोटोकॉल और Xero के API के बीच एक सेतु प्रदान करता है, जिससे Xero की लेखांकन और व्यावसायिक सुविधाओं तक मानकीकृत पहुँच संभव होती है।

विशेषताएँ

कस्टम कनेक्शन के साथ Xero OAuth2 प्रमाणीकरण
संपर्क प्रबंधन
खातों का चार्ट प्रबंधन
चालान निर्माण और प्रबंधन
MCP प्रोटोकॉल अनुपालन

पूर्वापेक्षाएँ

Node.js (v18 या उच्चतर)
npm या pnpm
API क्रेडेंशियल्स के साथ एक Xero डेवलपर खाता

दस्तावेज़ और लिंक

सेटअप

Xero खाता बनाएँ

यदि आपके पास पहले से Xero खाता और संगठन नहीं है, तो आप निःशुल्क परीक्षण का उपयोग करके यहाँ साइन अप करके एक बना सकते हैं।

हम शुरुआत में डेमो कंपनी का उपयोग करने की अनुशंसा करते हैं क्योंकि इसमें कुछ पूर्व-लोडेड नमूना डेटा होता है। एक बार लॉग इन करने के बाद, ऊपरी बाएँ ड्रॉपडाउन का उपयोग करके और "डेमो कंपनी" चुनकर इसमें स्विच करें। आप किसी भी समय ऊपरी बाएँ ड्रॉपडाउन का उपयोग करके और My Xero पर नेविगेट करके डेमो कंपनी का डेटा रीसेट कर सकते हैं, या देश बदल सकते हैं।

नोट: पेरोल-विशिष्ट क्वेरीज़ का उपयोग करने के लिए, क्षेत्र NZ या UK होना चाहिए।

प्रमाणीकरण

Xero MCP सर्वर में प्रमाणीकरण के 2 तरीके समर्थित हैं:

1. कस्टम कनेक्शन

यह परीक्षण और विकास के लिए एक बेहतर विकल्प है जो आपको किसी विशिष्ट संगठन के लिए क्लाइंट आईडी और सीक्रेट निर्दिष्ट करने की अनुमति देता है। यदि आप इसे Claude Desktop जैसे तृतीय-पक्ष MCP क्लाइंट में एकीकृत कर रहे हैं तो यह अनुशंसित दृष्टिकोण भी है।

अपने Xero डेवलपर खाते को कॉन्फ़िगर करना

इन निर्देशों का पालन करते हुए एक कस्टम कनेक्शन सेट करें: https://developer.xero.com/documentation/guides/oauth2/custom-connections/

आवश्यक स्कोप

कस्टम कनेक्शन के लिए अलग-अलग स्कोप की आवश्यकता होती है, जो इस बात पर निर्भर करता है कि वे कब बनाए गए थे। प्रासंगिक सूची के सभी स्कोप आपके कस्टम कनेक्शन में जोड़े जाने चाहिए:

कस्टम कनेक्शन बनाया गया	आवश्यक स्कोप
29 अप्रैल, 2026 से पहले	SCOPES_V1 (बंडल अनुमतियाँ)
29 अप्रैल, 2026 से	SCOPES_V2 (विस्तृत अनुमतियाँ)

नोट: MCP सर्वर स्वचालित रूप से पहले V1 स्कोप आज़माता है और यदि आवश्यक हो तो V2 पर फ़ॉलबैक करता है।

आप XERO_SCOPES पर्यावरण चर को स्पेस-पृथक स्कोप की सूची पर सेट करके इन्हें ओवरराइड कर सकते हैं।

MCP सर्वर को Claude Desktop के साथ एकीकृत करना

Claude में MCP सर्वर जोड़ने के लिए Settings > Developer > Edit config पर जाएँ और अपनी claude_desktop_config.json फ़ाइल में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here",
        "XERO_SCOPES": "accounting.invoices accounting.contacts accounting.settings"
      }
    }
  }
}

XERO_SCOPES चर वैकल्पिक है। यदि छोड़ दिया जाता है, तो ऊपर सूचीबद्ध डिफ़ॉल्ट स्कोप का उपयोग किया जाएगा।

नोट: यदि आप Node Version Manager का उपयोग कर रहे हैं तो "command": "npx" अनुभाग को निष्पादन योग्य के पूर्ण पथ में बदलें, अर्थात: Mac / Linux पर your_home_directory/.nvm/versions/node/v22.14.0/bin/npx या Windows पर "your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"

2. बियरर टोकन

यह एक बेहतर विकल्प है यदि आपको रनटाइम पर कई Xero खातों का समर्थन करना है और MCP क्लाइंट को आवश्यकतानुसार प्रमाणीकरण प्रवाह (जैसे PKCE) निष्पादित करने की अनुमति देनी है। इस मामले में, निम्नलिखित कॉन्फ़िगरेशन का उपयोग करें:

{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token"
      }
    }
  }
}

नोट: यदि परिभाषित किया गया है तो XERO_CLIENT_BEARER_TOKEN को XERO_CLIENT_ID पर प्राथमिकता दी जाएगी।

बियरर टोकन के लिए आवश्यक स्कोप

बियरर टोकन प्राप्त करते समय, आपको उपयुक्त स्कोप का अनुरोध करना होगा। आपको जिन स्कोप का अनुरोध करना चाहिए वे हैं:

नोट: कुछ स्कोप को अधिक विस्तृत स्कोप के पक्ष में हटाया जा रहा है। हटाने की समय-सीमा के विवरण के लिए Xero OAuth 2.0 स्कोप दस्तावेज़ीकरण देखें।

accounting.transactions (Deprecated)
accounting.transactions.read (Deprecated)
accounting.invoices
accounting.invoices.read
accounting.payments
accounting.payments.read
accounting.banktransactions
accounting.banktransactions.read
accounting.manualjournals
accounting.manualjournals.read
accounting.reports.read (Deprecated)
accounting.reports.aged.read
accounting.reports.balancesheet.read
accounting.reports.profitandloss.read
accounting.reports.trialbalance.read
accounting.contacts 
accounting.settings 
payroll.settings 
payroll.employees 
payroll.timesheets

उपलब्ध MCP कमांड

list-accounts: खातों की सूची प्राप्त करें
list-contacts: Xero से संपर्कों की सूची प्राप्त करें
list-credit-notes: क्रेडिट नोटों की सूची प्राप्त करें
list-invoices: चालानों की सूची प्राप्त करें
list-items: मदों की सूची प्राप्त करें
list-manual-journals: मैन्युअल जर्नल की सूची प्राप्त करें
list-organisation-details: किसी संगठन के बारे में विवरण प्राप्त करें
list-profit-and-loss: लाभ और हानि रिपोर्ट प्राप्त करें
list-quotes: कोटेशन की सूची प्राप्त करें
list-tax-rates: कर दरों की सूची प्राप्त करें
list-payments: भुगतानों की सूची प्राप्त करें
list-trial-balance: ट्रायल बैलेंस रिपोर्ट प्राप्त करें
list-bank-transactions: बैंक खाता लेन-देन की सूची प्राप्त करें
list-payroll-employees: पेरोल कर्मचारियों की सूची प्राप्त करें
list-report-balance-sheet: बैलेंस शीट रिपोर्ट प्राप्त करें
list-payroll-employee-leave: पेरोल कर्मचारी के अवकाश रिकॉर्ड प्राप्त करें
list-payroll-employee-leave-balances: पेरोल कर्मचारी के अवकाश शेष प्राप्त करें
list-payroll-employee-leave-types: पेरोल अवकाश प्रकारों की सूची प्राप्त करें
list-payroll-leave-periods: पेरोल कर्मचारी की अवकाश अवधियों की सूची प्राप्त करें
list-payroll-leave-types: Xero पेरोल में सभी उपलब्ध अवकाश प्रकारों की सूची प्राप्त करें
list-timesheets: पेरोल टाइमशीट की सूची प्राप्त करें
list-aged-receivables-by-contact: किसी संपर्क के लिए वृद्ध प्राप्य राशि प्राप्त करता है
list-aged-payables-by-contact: किसी संपर्क के लिए वृद्ध देय राशि प्राप्त करता है
list-contact-groups: संपर्क समूहों की सूची प्राप्त करें
list-tracking-categories: ट्रैकिंग श्रेणियों की सूची प्राप्त करें
create-bank-transaction: एक नया बैंक लेन-देन बनाएँ
create-contact: एक नया संपर्क बनाएँ
create-credit-note: एक नया क्रेडिट नोट बनाएँ
create-invoice: एक नया चालान बनाएँ
create-item: एक नई मद बनाएँ
create-manual-journal: एक नया मैन्युअल जर्नल बनाएँ
create-payment: एक नया भुगतान बनाएँ
create-quote: एक नया कोटेशन बनाएँ
create-payroll-timesheet: एक नई पेरोल टाइमशीट बनाएँ
create-tracking-category: एक नई ट्रैकिंग श्रेणी बनाएँ
create-tracking-option: एक नया ट्रैकिंग विकल्प बनाएँ
update-bank-transaction: मौजूदा बैंक लेन-देन अपडेट करें
update-contact: मौजूदा संपर्क अपडेट करें
update-invoice: मौजूदा ड्राफ़्ट चालान अपडेट करें
update-item: मौजूदा मद अपडेट करें
update-manual-journal: मौजूदा मैन्युअल जर्नल अपडेट करें
update-quote: मौजूदा ड्राफ़्ट कोटेशन अपडेट करें
update-credit-note: मौजूदा ड्राफ़्ट क्रेडिट नोट अपडेट करें
update-tracking-category: मौजूदा ट्रैकिंग श्रेणी अपडेट करें
update-tracking-options: ट्रैकिंग विकल्प अपडेट करें
update-payroll-timesheet-line: मौजूदा पेरोल टाइमशीट पर एक पंक्ति अपडेट करें
approve-payroll-timesheet: पेरोल टाइमशीट स्वीकृत करें
revert-payroll-timesheet: स्वीकृत पेरोल टाइमशीट वापस लें
add-payroll-timesheet-line: मौजूदा पेरोल टाइमशीट पर नई पंक्ति जोड़ें
delete-payroll-timesheet: मौजूदा पेरोल टाइमशीट हटाएँ
get-payroll-timesheet: मौजूदा पेरोल टाइमशीट प्राप्त करें

विस्तृत API दस्तावेज़ीकरण के लिए, कृपया MCP प्रोटोकॉल विनिर्देश देखें।

डेवलपर्स के लिए

स्थापना

# Using npm
npm install

# Using pnpm
pnpm install

बिल्ड चलाएँ

# Using npm
npm run build

# Using pnpm
pnpm build

Claude Desktop के साथ एकीकरण

विकास में अपने Xero MCP सर्वर को Claude Desktop से लिंक करने के लिए Settings > Developer > Edit config पर जाएँ और अपनी claude_desktop_config.json फ़ाइल में निम्नलिखित जोड़ें:

नोट: Windows के लिए सुनिश्चित करें कि args पथ फ़ोल्डरों के बीच \ से बच निकलता है अर्थात "C:\\projects\xero-mcp-server\\dist\\index.js"

{
  "mcpServers": {
    "xero": {
      "command": "node",
      "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

लाइसेंस

MIT

सुरक्षा

कृपया अपनी .env फ़ाइल या किसी भी संवेदनशील क्रेडेंशियल को संस्करण नियंत्रण में कमिट न करें (यह सुरक्षित डिफ़ॉल्ट के रूप में .gitignore में शामिल है।)