# contactapi MCP server

> Allows AI clients to create, list, update, and delete contacts and signups via a managed API.

- Repository: https://github.com/kozmos-tech/contactapi
- Page: https://hostedmcp.org/servers/kozmos-tech/contactapi
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add contactapi -- npx -y @kozmos-tech/contactapi
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "contactapi": {
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/contactapi"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "contactapi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/contactapi"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"contactapi","type":"stdio","command":"npx","args":["-y","@kozmos-tech/contactapi"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "contactapi": {
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/contactapi"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add contactapi -- npx -y @kozmos-tech/contactapi
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.contactapi]
command = "npx"
args = ["-y", "@kozmos-tech/contactapi"]
```

### Gemini CLI

```sh
gemini mcp add -s user contactapi npx -- -y @kozmos-tech/contactapi
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "contactapi": {
      "command": "npx",
      "args": [
        "-y",
        "@kozmos-tech/contactapi"
      ]
    }
  }
}
```

## FAQ

### How does the MCP server handle authentication?

It uses OAuth 2.1 with dynamic client registration, allowing the client to discover the authorization server and request access without needing to manually copy an API key.

### What tools are available through the MCP server?

The server provides five tools that mirror the REST API: list_contacts, get_contact, create_contact, update_contact, and delete_contact.

### How are duplicate contacts handled?

Contacts are keyed by email, so creating a contact with an existing email will update the existing record instead of creating a duplicate.
