contactapi MCP server
✓ VerifiedAllows AI clients to create, list, update, and delete contacts and signups via a managed API.
Also known as kozmos-tech/contactapi, @kozmos-tech/contactapi
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 203
- Latest version
- 0.1.1
- Last commit
- Jul 15, 2026
- License
- MIT
What is contactapi MCP?
contactapi allows AI clients to create, list, update, and delete contacts and signups via a managed API.
Summary generated from the project's README
About contactapi MCP server
Managing contact lists and signups directly from an AI interface is what this server enables. Developers using Claude Desktop, Cursor, or the MCP Inspector can perform full CRUD operations on their contact data through five specific tools: list_contacts, get_contact, create_contact, update_contact, and delete_contact. The system uses email addresses as unique keys, meaning the create_contact tool performs an upsert by updating existing entries instead of creating duplicates.
Setting up the connection is handled via OAuth 2.1 with dynamic client registration. Instead of manually copying API keys, you point your client to the provided URL, which triggers a login flow to approve access to your account. This remote connection ensures all actions are scoped to your specific user identity. The underlying API is built with Hono and deployed on Vercel, supporting both secret keys for full backend access and publishable keys for browser-based contact creation.
What you can do with it
- 1Syncing new signupsAn AI assistant can add a new user to your database using their email and custom JSON fields.
- 2Auditing contact listsYou can ask an AI to retrieve and display your entire list of contacts using pagination.
- 3Updating user informationA developer can instruct an AI to modify specific details for an existing contact via their unique ID.
- 4Removing outdated entriesYou can use an AI client to clean up your database by deleting specific contact records.
Written from the project's README. Every use case is checked against a quote from it.
How to install contactapi MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall contactapi MCP in Claude Code
$ claude mcp add contactapi -- npx -y @kozmos-tech/contactapiInstall contactapi MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"contactapi": {
"command": "npx",
"args": [
"-y",
"@kozmos-tech/contactapi"
]
}
}
}Install contactapi MCP in VS Code
.vscode/mcp.json
{
"servers": {
"contactapi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kozmos-tech/contactapi"
]
}
}
}Install contactapi MCP in VS Code CLI
$ code --add-mcp '{"name":"contactapi","type":"stdio","command":"npx","args":["-y","@kozmos-tech/contactapi"]}'Install contactapi MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"contactapi": {
"command": "npx",
"args": [
"-y",
"@kozmos-tech/contactapi"
]
}
}
}Install contactapi MCP in Codex
$ codex mcp add contactapi -- npx -y @kozmos-tech/contactapiInstall contactapi MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.contactapi] command = "npx" args = ["-y", "@kozmos-tech/contactapi"]
Install contactapi MCP in Gemini CLI
$ gemini mcp add -s user contactapi npx -- -y @kozmos-tech/contactapiInstall contactapi MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"contactapi": {
"command": "npx",
"args": [
"-y",
"@kozmos-tech/contactapi"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablekozmos-tech/contactapi is public and reachablegithub.com/kozmos-tech/contactapi ↗Pass
- Package names this repository as its source@kozmos-tech/contactapi names kozmos-tech/contactapi as sourcenpmjs.com/package/@kozmos-tech/contactapi ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-15github.com/kozmos-tech/contactapi ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @kozmos-tech/contactapiPass
- No critical advisory in the package or its dependencies85 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcontactapi
An open-source API to save contacts. Send a POST with an email and any other
JSON fields you want, and they get saved as-is. Manage them with simple CRUD.
Built with Hono and deployed on Vercel.
API overview
The base URL is https://contactapi.dev and every request carries your API key
as a Bearer token:
Authorization: Bearer YOUR_KEY
| Method | Path | Key | Description |
|---|---|---|---|
POST |
/v1/contacts |
secret or publishable | Create (or upsert) a contact by email |
GET |
/v1/contacts |
secret | List contacts, paginated |
GET |
/v1/contacts/:id |
secret | Fetch a single contact |
PATCH |
/v1/contacts/:id |
secret | Update a contact |
DELETE |
/v1/contacts/:id |
secret | Delete a contact |
Contacts are keyed by email — creating one whose email already exists updates it
in place rather than duplicating it. Full reference lives on the landing page and
in /llms.txt.
There are two kinds of key:
ck_secret_…— secret key, for your backend. Full access to every endpoint.ck_pub_…— publishable key, for the browser. Can only create contacts and is locked to your domains.
MCP server
AI clients (Claude Desktop, claude.ai custom connectors, Cursor, the MCP Inspector) can manage your contacts through an MCP server at:
https://contactapi.dev/mcp
Auth is OAuth 2.1 with dynamic client registration — point a client at the
URL and it discovers the authorization server, registers itself, and sends you to
log in and approve access; no API key to copy. The server exposes five tools that
mirror the REST API: list_contacts, get_contact, create_contact
(upsert-by-email), update_contact, and delete_contact. Everything is scoped to
the account you log in as.
The OAuth provider is Better Auth's mcp plugin
(src/auth.ts); the tools and endpoint wiring live in
src/mcp/server.ts and src/index.ts.
Development
Prerequisites: Vercel CLI installed globally.
npm install
vc dev
open http://localhost:3000
Build
npm install
vc build
Deploy
npm install
vc deploy
License
contactapi MCP questions
How do I add contactapi MCP to Claude Code?
Run claude mcp add contactapi -- npx -y @kozmos-tech/contactapi in your terminal. Add --scope user to make it available in every project.
How do I add contactapi MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
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.