Add tool to find DEVONthink records by citation key and vice versa

Author: TomBener

CLAUDE.md

@@ -33,8 +33,12 @@
   - **`duplicateRecord.ts`**: Duplicates records to any database (creates independent copies)
   - **`convertRecord.ts`**: Converts records to different formats
   - **`updateRecordContent.ts`**: Updates the content of existing records while preserving UUID
+  - **`getZoteroMetadata.ts`**: Looks up Zotero metadata for DEVONthink records using Finder paths or record identifiers
+  - **`findRecordsByCitationKey.ts`**: Resolves Zotero citation keys to attachment metadata and matching DEVONthink records
 - **`src/utils/`**: Utility functions
   - **`escapeString.ts`**: Provides safe string escaping for JXA script interpolation
+  - **`jxaHelpers.ts`**: Shared helper functions injected into JXA scripts for record lookup and conversion
+  - **`zoteroMetadata.ts`**: Loads Zotero export files and resolves attachment metadata by Finder path
 - **`src/applescript/execute.ts`**: A utility module that provides the `executeJxa` function to run JXA scripts via the command line.
 
 ## Available Tools
@@ -64,6 +68,8 @@ The MCP server currently provides the following tools:
 21. **`duplicate_record`** - Duplicate records to any database (creates independent copies)
 22. **`convert_record`** - Convert records to different formats (plain text, rich text, markdown, HTML, PDF, etc.)
 23. **`update_record_content`** - Update the content of existing records while preserving UUID and metadata
+24. **`get_zotero_metadata`** - Look up Zotero attachment metadata for a DEVONthink record or Finder path, returning handy top-level `citationKey`, `zoteroId`, attachment listings, and a short `metadataSummary`
+25. **`find_records_by_citation_key`** - Resolve a Zotero citation key to its attachment metadata and any DEVONthink records whose Finder paths match those attachments
 
 ## Adding New Tools
 

README.md

@@ -1,6 +1,8 @@
-# Devonthink MCP Server
+Modified based on [dvcrn/mcp-server-devonthink](https://github.com/dvcrn/mcp-server-devonthink)
 
-This MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS.
+# DEVONthink Zotero MCP Server
+
+This MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS. Additionally, it includes tools to resolve Zotero metadata for DEVONthink attachments based on exported Zotero data.
 
 ![screenshot](./screenshot.png)
 
@@ -12,6 +14,8 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
 - Retrieve and modify record content, properties, and tags
 - Create records from URLs in multiple formats
 - List open databases and group contents
+- Resolve Zotero metadata for DEVONthink attachments via Zotero exports
+- Locate DEVONthink records directly from Zotero citation keys or attachment metadata
 - All tools are type-safe and validated with Zod schemas
 
 ## Tools
@@ -100,6 +104,16 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
     - Input: primary record UUID, optional second record UUID, database name, and comparison type
     - Returns: Either similar records (single mode) or detailed comparison analysis (two-record mode)
 
+17. `get_zotero_metadata`
+    - Resolves Zotero metadata for a DEVONthink record or Finder path
+    - Input: Finder path, record UUID, DEVONthink ID + database, or DEVONthink location path (optional `zoteroJsonPath` / `zoteroBibPath` override export locations)
+    - Returns: The matched Zotero item with top-level `citationKey`, `zoteroId`, attachment list, and a short summary string for LLM prompts
+
+18. `find_records_by_citation_key`
+    - Resolves a Zotero citation key to its attachment metadata and matching DEVONthink records
+    - Input: `citationKey` along with optional overrides for Zotero JSON/BibTeX export paths
+    - Returns: Zotero metadata (JSON or BibTeX) plus any DEVONthink records whose Finder paths match the attachment entries
+
 ### Example: Search Tool
 
 ```json
@@ -144,3 +158,28 @@ Add to your Claude configuration:
 - Includes comprehensive tests using Vitest
 
 See [CLAUDE.md](./CLAUDE.md) for full documentation, tool development guidelines, and API reference.
+
+## Zotero Metadata Lookup
+
+Zotero attachments stored in DEVONthink can be matched to exported Zotero metadata. The MCP server inspects both JSON and BibTeX exports and prefers JSON when both are present.
+
+1. Export your Zotero library (or a subset) to `bibliography.json` and/or `bibliography.bib`.
+2. Point the server at the exports via environment variables before launching it (using Claude's MCP configuration or your shell):
+
+   ```bash
+   export ZOTERO_BIBLIOGRAPHY_JSON="/path/to/bibliography.json"   # optional
+   export ZOTERO_BIBLIOGRAPHY_BIB="/path/to/bibliography.bib"     # optional
+   ```
+
+   - Supplying only one file is fine—the server detects whether you provided a `.json` or `.bib` path and uses it automatically.
+   - If no metadata file is configured, the tool returns an informative error so you can correct the setup.
+
+3. Call the `get_zotero_metadata` tool with a Finder path or any supported DEVONthink identifier. The tool returns the matched Zotero entry (including citation key, fields, and the property that matched), exposes `citationKey` / `zoteroId` at the top level, and provides a brief `metadataSummary` string for LLM prompts. If no match is found, the response lists the files that were checked.
+
+Example invocation:
+
+```json
+{
+  "uuid": "7F8C5A5B-1234-5678-ABCD-9876543210EF"
+}
+```

package-lock.json

@@ -32,6 +32,8 @@ import { replicateRecordTool } from "./tools/replicateRecord.js";
 import { duplicateRecordTool } from "./tools/duplicateRecord.js";
 import { convertRecordTool } from "./tools/convertRecord.js";
 import { updateRecordContentTool } from "./tools/updateRecordContent.js";
+import { getZoteroMetadataTool } from "./tools/getZoteroMetadata.js";
+import { findRecordsByCitationKeyTool } from "./tools/findRecordsByCitationKey.js";
 
 export const createServer = async () => {
 	const server = new Server(
@@ -72,6 +74,8 @@ export const createServer = async () => {
 		duplicateRecordTool,
 		convertRecordTool,
 		updateRecordContentTool,
+		getZoteroMetadataTool,
+		findRecordsByCitationKeyTool,
 	];
 
 	server.setRequestHandler(ListToolsRequestSchema, async () => {