Contact MCP Server

MCP Server for the Infomaniak Contacts API.

Tools

1. contact_list

   • List all contacts across all address books in your Infomaniak account

   • Returns: Full contact records with name, emails, phones, and other fields

2. contact_search

   • Search contacts by name, email, or phone number

   • Required inputs:

     • query (string): Search query string

   • Returns: Matching contacts with full details

Related MCP server: contacts-mcp

Setup

1. Create a token linked to your user:

   • Visit the API Token page

   • Choose "contacts" scope

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "contact": {
      "command": "npx",
      "args": [
        "-y",
        "@infomaniak/mcp-server-contact"
      ],
      "env": {
        "CONTACT_TOKEN": "your-token"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "contact": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONTACT_TOKEN",
        "infomaniak/mcp-server-contact"
      ],
      "env": {
        "CONTACT_TOKEN": "your-token"
      }
    }
  }
}

Environment Variables

1. CONTACT_TOKEN: Required. Your Infomaniak API token with contacts scope.

Troubleshooting

If you encounter permission errors, verify that:

1. The token has the "contacts" scope

2. The token is correctly copied to your configuration

Build

Docker build:

docker build -t infomaniak/mcp-server-contact -f Dockerfile .

License

This MCP server is licensed under the MIT License.