quillink-mcp

MCPサーバーで、Quillinkのノート、フォルダ、タグへの読み取り専用アクセスを、Claude Desktop、Claude Code、その他のMCP互換クライアントなどのAIツールに提供します。

ProのQuillinkプランが必要です（APIアクセスはPro限定機能です）。

PyPIには公開されていません。ソースからローカルでビルドして実行してください。

ビルド

git clone https://github.com/dagistankaradeniz/gcp-note-taking-mcp.git
cd gcp-note-taking-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

これにより、quillink-mcpコマンドが.venv/bin/にインストールされます。そのバイナリのフルパス（例：/Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp）に注意してください。MCPクライアントはアクティブなシェルを介さずに直接起動するため、絶対パスが必要です。

Related MCP server: Bruin

認証

2つのオプションがあります：

オプションA — OAuthデバイスログイン（対話的な使用に推奨）：

.venv/bin/quillink-mcp login

デバイスコードと確認URLが開きます。ブラウザで承認してください。トークンはOSのキーリング（またはフォールバックとして~/.config/quillink-mcp/credential）に保存されます。

オプションB — パーソナルアクセストークン：

Quillinkの設定 → 開発者 → トークンで作成し（スコープ：notes:read、folders:read、tags:read）、環境変数として設定してください：

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKENは、保存されたOAuthログインよりも常に優先されます。

Claude Desktopでの使用

Claude Desktopの設定（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp"
    }
  }
}

loginの代わりにPATを使用する場合は、設定で環境変数として渡します：

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp",
      "env": { "QUILLINK_TOKEN": "qlk_pat_..." }
    }
  }
}

設定を編集した後、Claude Desktopを再起動してください。

他のMCPクライアントでの使用

ローカルのstdio MCPサーバーを起動できるクライアントはすべて同じように動作します：.venv/bin/quillink-mcpの絶対パスを指定します（QUILLINK_TOKENを設定するか、quillink-mcp loginを一度実行して資格情報を保存しておきます）。これにはClaude Code（claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp）や、MCP stdioトランスポートをサポートするOpenAI互換のエージェントランタイムが含まれます。

ツール

すべて読み取り専用です。このサーバーは何も作成、編集、削除できません。

Vaultノートはここでは決してアクセスできません。クライアント側でエンドツーエンドに暗号化されているため、このサーバーを含むどのサーバーも読み取ることができません。組織ツールは、Teamプランの組織に属していない呼び出し元には404を返します。

設定（環境変数）

直接実行（テスト用）

.venv/bin/quillink-mcp login
.venv/bin/quillink-mcp   # runs the server on stdio -- an MCP client normally launches this for you