LROC-NY/clio-mcp-server
If you are the rightful owner of clio-mcp-server 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.
The Clio MCP Server is a cross-platform server designed to integrate Clio legal practice management with AI assistants like Claude, providing seamless access to Clio's API resources.
Clio MCP Server
A Model Context Protocol (MCP) server for integrating Clio legal practice management with AI assistants like Claude.
Features
ā Fully Implemented
- š OAuth 2.0 Authentication: Secure token-based authentication
- š Multi-region Support: US, EU, CA, and AU Clio instances
- š Matter Management: Create, read, update matters
- š„ Contact Management: Full CRUD operations with email/phone fields
- ā Task Management: Create and manage tasks
- š Calendar Integration: Access calendar entries
- ā±ļø Time Tracking: Activities and time entries
- š° Billing: Access bills and financial data
- š Document Management: Upload, download, list documents and folders
- š¬ Communications: Log and track client communications
- š§ Custom Fields: Read and update custom field values
ā ļø Limited Support
- Clio Grow: Only lead submission API available (requires separate inbox_lead_token)
ā Not Available (No Public API)
- Clio Draft Features:
- Document templates
- Court forms
- eSignatures
- Document automation
- These features are only available through the Clio web interface
Quick Start
Installation
# Clone the repository
git clone https://github.com/LROC-NY/clio-mcp-server.git
cd clio-mcp-server
# Install dependencies
npm install
Configuration
-
Get Clio API Credentials:
- Log in to Clio
- Go to Settings ā Developer Applications
- Create a new application or use existing
- Copy Client ID and Client Secret
-
Configure the Server:
Create clio-config.json
:
{
"clientId": "YOUR_CLIENT_ID",
"clientSecret": "YOUR_CLIENT_SECRET",
"region": "US"
}
Or use environment variables (.env
):
CLIO_CLIENT_ID=your_client_id
CLIO_CLIENT_SECRET=your_client_secret
CLIO_REGION=US
- Get Access Token:
# Get OAuth URL
node oauth-helpers/get-auth-url.js
# Visit the URL, authorize, and get the code
# Exchange code for token
node oauth-helpers/exchange-code.js YOUR_AUTH_CODE
Platform Setup
Claude Code
Add to your Claude Code configuration:
claude mcp add-json clio '{
"type": "stdio",
"command": "node",
"args": ["/path/to/clio-mcp-server/src/index.js"],
"env": {
"CLIO_CLIENT_ID": "your_client_id",
"CLIO_CLIENT_SECRET": "your_client_secret"
}
}'
Claude Desktop
Add to your Claude Desktop MCP settings with the appropriate configuration.
Available Tools
Core Management
get_matters
- Retrieve legal mattersget_contacts
- Retrieve contacts with emails/phonesget_tasks
- Retrieve taskscreate_task
- Create new tasksget_activities
- Retrieve time entriesget_calendar_entries
- Retrieve calendar events
Document Management
list_documents
- List documentsget_document
- Get document detailsupload_document
- Upload new documentdownload_document
- Download documentdelete_document
- Delete documentlist_folders
- List document folderscreate_folder
- Create new folder
Financial
get_bills
- Retrieve billsget_trust_accounts
- Get trust account information
Communications
get_contact_communications
- Get communication historylog_communication
- Log a new communication
Custom Fields
get_custom_fields
- Get custom field definitionsget_matter_with_custom_fields
- Get matter with custom field valuesupdate_custom_field
- Update custom field value
Clio Grow (Limited)
submit_lead_to_inbox
- Submit lead to Clio Grow (requires inbox_lead_token)
Testing
Run the test suite:
# Test basic connectivity
node tests/test-basic.js
# Test specific features
node tests/test-corrected.js
# Test contact management
node tests/test-contact-emails.js
API Limitations
Clio Draft
Clio Draft does not provide a public API. Features like document templates, court forms, and eSignatures are only available through the Clio web interface.
Clio Grow
Only the lead submission endpoint is available. Full lead management requires using the Clio Grow web interface.
Rate Limits
Clio API has rate limiting. The server includes automatic retry logic for rate-limited requests.
Project Structure
clio-mcp-server/
āāā src/
ā āāā index.js # Main MCP server
ā āāā api.js # API client
ā āāā auth.js # OAuth handling
ā āāā config.js # Configuration loader
ā āāā tools/
ā āāā additional-tools.js # Bills, users, etc.
ā āāā client-communication.js # Contact management
ā āāā custom-fields.js # Custom fields
ā āāā document-management.js # Documents/folders
ā āāā clio-grow-fixed.js # Lead submission
āāā oauth-helpers/ # OAuth flow scripts
āāā tests/ # Test scripts
āāā clio-config.json # Configuration file
Troubleshooting
"No access token" error
- Run the OAuth flow to get a fresh token
- Tokens expire after 30 days
404 errors on API calls
- Verify the endpoint exists in Clio's API documentation
- Check if the feature requires additional Clio subscriptions
- Some features (Clio Draft) have no API access
Connection errors
- Verify your Clio region setting (US/EU/CA/AU)
- Check network connectivity
- Ensure API credentials are correct
Contributing
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Submit a pull request
License
MIT License - see LICENSE file for details
Support
- GitHub Issues: Report bugs or request features
- Clio API Docs: developers.clio.com
- MCP Docs: modelcontextprotocol.org