contactapi

contactapi

連絡先を保存するオープンソース API です。メールアドレスと、必要な任意の JSON フィールドを指定して POST を送信すると、そのまま保存されます。シンプルな CRUD で管理できます。

Hono で構築され、Vercel にデプロイされています。

• ランディングページとドキュメント — /
• ログイン — /login
• サインアップ — /signup
• LLM 向けドキュメント — /llms.txt

API の概要

ベース URL は https://contactapi.dev です。すべてのリクエストで、API キーを Bearer トークンとして送信します。

Authorization: Bearer YOUR_KEY

メソッド	パス	キー	説明
POST	/v1/contacts	シークレットまたは公開可能	メールアドレスで連絡先を作成（またはアップサート）
GET	/v1/contacts	シークレット	連絡先の一覧を取得（ページネーション対応）
GET	/v1/contacts/:id	シークレット	連絡先を 1 件取得
PATCH	/v1/contacts/:id	シークレット	連絡先を更新
DELETE	/v1/contacts/:id	シークレット	連絡先を削除

連絡先はメールアドレスをキーとして管理されます。すでに存在するメールアドレスで連絡先を作成すると、重複して登録されるのではなく、既存の連絡先が更新されます。詳細なリファレンスはランディングページと /llms.txt にあります。

キーは 2 種類あります。

• ck_secret_… — バックエンド用のシークレットキーです。すべてのエンドポイントに完全アクセスできます。
• ck_pub_… — ブラウザー用の公開可能キーです。連絡先の作成のみ可能で、使用できるドメインが制限されます。

MCP サーバー

AI クライアント（Claude Desktop、claude.ai のカスタムコネクター、Cursor、MCP Inspector）から、次の MCP サーバーを通じて連絡先を管理できます。

https://contactapi.dev/mcp

認証方式は動的クライアント登録に対応した OAuth 2.1です。クライアントに URL を指定すると、認可サーバーを検出して自身を登録し、ログインとアクセス承認を行うページに移動します。API キーをコピーする必要はありません。このサーバーは REST API に対応する 5 つのツール、list_contacts、get_contact、create_contact（メールアドレスによるアップサート）、update_contact、delete_contact を公開します。すべての操作は、ログインしたアカウントの範囲内で行われます。

OAuth プロバイダーには Better Auth の mcp プラグイン（src/auth.ts）を使用しています。ツールとエンドポイントの設定は src/mcp/server.ts と src/index.ts にあります。

開発

前提条件：グローバルにインストールされた Vercel CLI。

npm install
vc dev
open http://localhost:3000

ビルド

npm install
vc build

デプロイ

npm install
vc deploy

ライセンス

MIT