Scala3-based MCP server implementation PoC that connects to your Capsule CRM data.

You can get started with the server and use it with your favourite AI assistant.

1. Log into your Capsule CRM account
2. Go to My Preferences → API Authentication
3. Create a new API token and copy it

# Clone this repo:
git clone [email protected]:zestia/capsule-mcp-scala.git
cd capsule-mcp-scala

# Install jEnv (skip if already installed):
brew install jenv

# Add jenv to your zsh (skip if already installed):
echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(jenv init -)"' >> ~/.zshrc

# reload your terminal session:
exec $SHELL -l

# Install Java 17 and add to jenv (skip if already installed):
brew install openjdk@17
jenv add $(/usr/libexec/java_home -v 17)

# Install scala-cli (skip if already installed):
brew install Virtuslab/scala-cli/scala-cli

# reload your terminal session:
exec $SHELL -l

Confirm jEnv and scala-cli installation with:

jenv --version
scala-cli --version

Coming soon

Add the following to your Claude Desktop config file and replace:

1. your-api-token with your Capsule API token.
2. /path/to/your/ with the path to your capsule-mcp-scala directory that you cloned via git.

Config Location:

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

{
  "mcpServers": {
    "capsule-mcp": {
      "command": "/path/to/your/capsule-mcp-scala/runServer.sh",
      "args": [],
      "transport": "stdio",
      "env": {
        "CAPSULE_API_TOKEN": "your-api-token",
        "WORKSPACE": "/path/to/your/capsule-mcp-scala"
      }
    }
  }
}

You can also optionally override the CAPSULE_BASE_URL environment variable to point to a different Capsule CRM instance.

{
  "mcpServers": {
    "capsule-mcp": {
      "command": "/Users/mirandahawkes/projects/capsule-mcp-scala/runServer.sh",
      "args": [],
      "transport": "stdio",
      "env": {
        "CAPSULE_API_TOKEN": "abc123",
        "CAPSULE_BASE_URL": "https://api.capsule.run",
        "WORKSPACE": "/Users/mirandahawkes/projects/capsule-mcp-scala"
      }
    }
  }
}

This server is compatible with any MCP client. Refer to your client's documentation for MCP server configuration.

1. Restart your AI assistant
2. Start asking questions

This MCP server provides complete read-only access to your Capsule CRM:

There are a few options for running / testing the server locally during development.

Refer to Quick Start.

The MCP Inspector is an interactive developer tool for testing and debugging MCP servers.

See developer documentation for installation.

scala-cli clean . && npx @modelcontextprotocol/inspector scala-cli . -e CAPSULE_API_TOKEN=yourToken -e CAPSULE_BASE_URL=https://api.capsule.run

Running your MCP server via your AI Assistant or the MCP Inspector starts up the server via scala-cli in the background. To run this manually instead, use:

export CAPSULE_API_TOKEN=yourToken
export CAPSULE_BASE_URL=baseUrl
scala-cli clean . && scala-cli run .

You can optionally override CAPSULE_BASE_URL=baseUrl to test against a specific instance of Capsule. The default is https://api.capsulecrm.com.

Note that if you make changes to files, you will need to restart the server to pick these up.

Server logs are written to /capsule-mcp-scala/capsule-mcp.log.