mcp-tomorro

MCP (Model Context Protocol) server for Tomorro contract management platform.

Features

This MCP server provides 35+ tools to interact with Tomorro's GraphQL API:

Contract Management

• list_contracts - List all contracts with filtering and pagination
• get_contract - Get contract details
• create_contract - Create a new contract
• update_contract - Update an existing contract
• delete_contract - Delete a contract
• get_contract_files - Get files attached to a contract
• get_contract_members - Get members associated with a contract
• get_contract_links - Get linked contracts

Templates

• list_templates - List all templates
• get_template - Get template details
• get_template_signatories - Get template signatories

Contract Types

• list_types - List all contract types
• get_type - Get type details

External Companies (Counterparties)

• list_external_companies - List all external companies
• get_external_company - Get company details
• create_external_company - Create a new company
• update_external_company - Update a company

Documents

• list_documents - List documents for a contract
• get_last_document - Get the latest document
• create_document - Create a new document

Members

• list_members - List organization members
• get_member - Get member details

Signatures

• get_signature - Get signature status for a contract
• can_send_signature - Check if signature can be sent
• accept_for_signature - Start signature process
• cancel_signature - Cancel signature process
• create_signatory - Add a signatory
• get_signature_fields - Get signature field positions

Audit Logs

• get_audit_logs - Get activity logs

Attributes

• list_attribute_definitions - List metadata field definitions
• get_attribute_definition - Get attribute definition
• update_contract_attributes - Update contract metadata

Custom Objects

• list_custom_objects - List custom objects
• get_custom_object - Get custom object details

API Info

• get_current_api_key - Get current API key info
• get_features - Get available features

Installation

npm install
npm run build

Configuration

Set the following environment variables:

export TOMORRO_API_KEY="your-api-key"
export TOMORRO_API_URL="https://api.tomorro.com/graphql"  # Optional, this is the default

You can generate an API key in Tomorro at: https://app.tomorro.com/integrations (API section)

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tomorro": {
      "command": "node",
      "args": ["/path/to/mcp-tomorro/build/index.js"],
      "env": {
        "TOMORRO_API_KEY": "your-api-key"
      }
    }
  }
}

Development

# Watch mode for development
npm run watch

# Test with MCP Inspector
npm run inspector

API Reference

This server uses Tomorro's public GraphQL API. For more information:

• API Documentation
• Authentication
• Help Center

Entity Glossary

| API Name | Tomorro UI Name | |----------|-----------------| | type | Template | | template | Template document | | contract | Project | | document | Project document | | externalCompany | Counterparty |

License

MIT