unanet-mcp-server

Name: unanet-mcp-server
Availability: InStock
Author: Christian Ulstrup

MCP server connecting Claude Desktop to Unanet GovCon ERP - Manage projects, timesheets, and reports with natural language

GitHub Website

GitHubスター

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

イシュー

README

Unanet GovCon ERP MCP Server

Transform your 30-minute Unanet reports into 30-second conversations with AI

🎯 For GovCon Leaders Who Are Tired Of:

Clicking through 10 screens to answer one question
Waiting 20 minutes for reports that should take 20 seconds
Training new employees on complex ERP navigation
Missing critical project updates buried in data

🚀 What if you could just ask: "Give me an executive briefing on all projects"?

⏱️ Save 2-4 hours per week on ERP tasks:

Project Managers: Instant status updates, resource allocation checks, budget tracking
Executives: Daily briefings in seconds, not spreadsheets
Finance Teams: Real-time billing status, instant invoice generation
Everyone: No more clicking through 10 screens to find one answer

💡 See It In Action

From Complex Navigation to Simple Questions

Before: Log in → Projects → Select Project → Export → Format in Excel → Write Summary (15-30 min)

After: "What's the status of all active projects?" (30 seconds)

🎯 Quick Start

For Windows Users: Download → Run setup-windows.bat → Done! Detailed Guide

For Technical Users: See Installation below

🎯 What You Can Do

Ask Claude natural questions about your Unanet data:

✅ "Show me all projects over budget"
✅ "Submit 8 hours to Project Alpha for today"
✅ "Generate a compliance report for Q4"
✅ "Which team members are overallocated next month?"
✅ "Create an invoice for project DEF456"

No more memorizing menu paths or waiting for reports to load!

💰 ROI & Time Savings

Based on real GovCon operations:

Project Managers: Save 2-4 hours per week
Executives: Save 1-2 hours daily on status updates
Finance Teams: Cut monthly billing reconciliation time by 75%
Everyone: Get answers in seconds, not minutes

Real Example: Executive Daily Briefing

Traditional Method: Run reports → Export data → Analyze → Format (20+ minutes)
With Claude: "Give me an exec daily briefing" (30 seconds)

Executive Daily Briefing - Unanet Projects

• Portfolio Health: 2 active projects ($350K total budget) tracking on schedule
• Project Alpha: 50% complete with proportional budget burn - entering critical phase
• Project Beta: Early stage execution at 25% complete, healthy trajectory
• Resource Status: Team allocation stable, no conflicts identified
• Risk Assessment: All projects green status

Recommended Action: Schedule mid-project review for Alpha this week

📸 See More Power User Examples

Features

Tools Available

Project Management

unanet_get_projects - List all projects with filtering options
unanet_get_project_details - Get detailed information about a specific project
unanet_update_project_budget - Update project budget
unanet_get_project_status - Get project status and dashboard metrics

Time & Expense Tracking

unanet_submit_timesheet - Submit time entries
unanet_get_timesheets - Retrieve timesheets for a date range
unanet_submit_expense - Submit expense reports
unanet_approve_timesheet - Approve submitted timesheets

Contact Management

unanet_create_contact - Create new contacts
unanet_update_lead - Update lead information
unanet_create_opportunity - Create new opportunities
unanet_get_company_info - Get company details

Financial Operations

unanet_get_billing_status - Get project billing information
unanet_generate_invoice - Generate project invoices
unanet_get_financial_report - Generate various financial reports

Resources Available

unanet://projects/active - List of active projects
unanet://timesheets/templates - Timesheet templates and common entries

Installation

🪟 Windows Users (Recommended)

Download the project:
- Download from GitHub as a ZIP file
- Extract to C:\UnanetMCP\
Run the automated setup:
- Double-click setup-windows.bat
- Follow the prompts

That's it! See Windows Setup Guide for detailed instructions.

🐧 Mac/Linux Users

Clone this repository:

git clone https://github.com/culstrup/unanet-mcp-server.git
cd unanet-mcp-server

Install dependencies:

npm install

Build the project:

npm run build

Set up your environment variables:

cp .env.example .env
# Edit .env with your Unanet credentials

Configuration

Environment Variables

Create a .env file with your Unanet credentials:

UNANET_USERNAME=your-username
UNANET_PASSWORD=your-password
UNANET_API_KEY=your-api-key
UNANET_FIRM_CODE=your-firm-code
UNANET_BASE_URL=https://your-instance.unanet.com

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unanet": {
      "command": "node",
      "args": ["/absolute/path/to/unanet-mcp-server/dist/index.js"],
      "env": {
        "UNANET_USERNAME": "your-username",
        "UNANET_PASSWORD": "your-password",
        "UNANET_API_KEY": "your-api-key",
        "UNANET_FIRM_CODE": "your-firm-code",
        "UNANET_BASE_URL": "https://your-instance.unanet.com"
      }
    }
  }
}

Usage Examples

Once configured, you can interact with Unanet through Claude:

Project Management

"Show me all active projects"
"Get details for project ABC123"
"Update the budget for project XYZ to $150,000"
"What's the status of the government contract project?"

Time Tracking

"Submit 8 hours for project ABC123 for today"
"Show my timesheets for last week"
"Approve timesheet TS-2024-001"

Financial Reports

"Generate a project profitability report for Q4"
"Show billing status for project DEF456"
"Create an invoice for the last billing period"

Contact Management

"Create a new contact: John Smith from ABC Corp"
"Update the lead status to 'Proposal' with 75% probability"
"Create a new opportunity worth $500k closing next month"

Development

Running in Development Mode

npm run dev

Project Structure

src/
├── index.ts           # Main server entry point
├── auth.ts            # Authentication handling
├── tools/             # MCP tool implementations
│   ├── projects.ts    # Project management tools
│   ├── timesheet.ts   # Time/expense tools
│   ├── contacts.ts    # Contact management
│   └── financials.ts  # Financial tools
├── resources/         # MCP resource providers
│   └── reports.ts     # Report resources
└── types/             # TypeScript type definitions
    └── unanet.ts      # Unanet API types

Adding New Tools

Create a new tool in the appropriate file under src/tools/
Export the tool definition with:
- name: Unique tool identifier
- description: Clear description of what the tool does
- inputSchema: Zod schema for input validation
- handler: Async function that executes the tool
Import and add the tool to the tools array in src/index.ts

Security Considerations

Never commit your .env file
Use environment variables for all sensitive data
The server implements rate limiting protection
All API calls use HTTPS
Credentials are transmitted using Basic Auth + API Key

Troubleshooting

Authentication Errors

Verify your credentials in the .env file
Ensure your API key has the necessary permissions
Check that your firm code is correct

Connection Issues

Verify the UNANET_BASE_URL is correct
Check network connectivity
Ensure the Unanet API is accessible from your network

Claude Desktop Integration

Restart Claude Desktop after configuration changes
Check the logs for any MCP connection errors
Verify the absolute path to the server is correct

Support

For issues or questions:

Check the Unanet API documentation
Review the MCP documentation at https://modelcontextprotocol.io
Open an issue in this repository

🎯 Getting Started Today

Option 1: Quick Setup (Windows)

Download this repository
Run setup-windows.bat
Start asking Claude about your Unanet data!

Option 2: Manual Setup
See Installation for Mac/Linux or advanced setup

💬 Join the Conversation

Are you using AI to transform your GovCon operations? Let's connect!

🌟 Star this repo if you find it useful
🔄 Share your Unanet automation success stories
💡 Suggest features or improvements via Issues

About GSD at Work LLC

We help GovCon CEOs integrate AI into their core business operations and accelerate growth. From DoD contractors to civilian agencies, we're transforming how government contractors work.

What We Do: