Simplicate MCP Server
A Model Context Protocol (MCP) server that integrates with Simplicate, enabling AI assistants like Claude to securely access and interact with your Simplicate business data including CRM, projects, timesheets, and invoices.
Overview
This MCP server exposes Simplicate's API through the Model Context Protocol, allowing AI tools to:
Retrieve projects, organizations, persons, hours, and invoices
Search across Simplicate resources
Access detailed information about specific entities
Prerequisites
Node.js 18+ and npm
A Simplicate account with API credentials
Claude Desktop app (for testing with Claude)
Installation
Clone or download this repository
Install dependencies:
Create a
.env
file based on.env.example
:
Edit
.env
and add your Simplicate API credentials:
Getting Simplicate API Credentials:
Log in to your Simplicate account
Navigate to Settings → API
Generate or retrieve your API key and secret
Update the
SIMPLICATE_API_BASE_URL
with your actual Simplicate domain
Usage
Running the Server
Development mode (with TypeScript):
Production mode (compile first):
Connecting to Claude Desktop
To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Alternatively, using ts-node
for development:
After updating the configuration, restart Claude Desktop.
Available Tools
The MCP server exposes the following tools to AI assistants:
Projects
get_projects
- Retrieve a list of projectsget_project
- Get details of a specific project by ID
Organizations (CRM)
get_organizations
- Retrieve a list of organizationsget_organization
- Get details of a specific organization by ID
Persons (Contacts)
get_persons
- Retrieve a list of personsget_person
- Get details of a specific person by ID
Hours (Timesheets)
get_hours
- Retrieve timesheet hours
Invoices
get_invoices
- Retrieve invoices
Search
search
- Search across Simplicate resources (projects, organizations, persons)
Available Resources
The server also exposes the following resources that can be read by AI assistants:
simplicate://projects
- All projectssimplicate://organizations
- All organizationssimplicate://persons
- All personssimplicate://hours
- Timesheet hourssimplicate://invoices
- All invoices
Project Structure
Security Notes
Never commit your
.env
file or expose your API credentialsThe
.env
file is included in.gitignore
by defaultUse environment variables for production deployments
Simplicate API credentials are transmitted securely via HTTPS
Development
Building
Watch mode (auto-rebuild on changes)
Troubleshooting
Authentication Errors
Verify your API key and secret are correct
Ensure your Simplicate API base URL is correct (including your domain)
Check that your API credentials have the necessary permissions
Connection Issues
Ensure the MCP server is running
Check Claude Desktop config file syntax (valid JSON)
Verify the absolute path to the server entry point
Restart Claude Desktop after config changes
API Rate Limits
Simplicate may have API rate limits; adjust pagination parameters if needed
Consider caching frequently accessed data
Contributing
Contributions are welcome! Please ensure:
Code follows TypeScript best practices
All new features include appropriate error handling
Documentation is updated for new features
License
MIT
Resources
Support
For issues related to:
MCP Server: Open an issue in this repository
Simplicate API: Contact Simplicate Support
Claude/MCP Protocol: Visit Anthropic's Documentation
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables AI assistants to securely access and interact with Simplicate business data including CRM, projects, timesheets, and invoices through natural language. Supports searching across resources and retrieving detailed information about organizations, contacts, and project data.