You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,8 +68,8 @@ The MCP server currently provides the following tools:
68
68
21.**`duplicate_record`** - Duplicate records to any database (creates independent copies)
69
69
22.**`convert_record`** - Convert records to different formats (plain text, rich text, markdown, HTML, PDF, etc.)
70
70
23.**`update_record_content`** - Update the content of existing records while preserving UUID and metadata
71
-
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`
72
-
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
71
+
24.**`get_bib_metadata`** - Look up bibliography metadata for a DEVONthink record or Finder path, returning top-level `citationKey`, `zoteroId`, attachment listings, and a short `metadataSummary`
72
+
25.**`get_records_by_citekey`** - Resolve a citation key to its attachment metadata and any DEVONthink records whose Finder paths match those attachments
Copy file name to clipboardExpand all lines: README.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
Modified based on [dvcrn/mcp-server-devonthink](https://github.com/dvcrn/mcp-server-devonthink)
2
2
3
-
# DEVONthink Zotero MCP Server
3
+
# DEVONthink MCP Server
4
4
5
-
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.
5
+
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 bibliography metadata for DEVONthink attachments based on exported bibliography data.
6
6
7
7

8
8
@@ -14,8 +14,8 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
14
14
- Retrieve and modify record content, properties, and tags
15
15
- Create records from URLs in multiple formats
16
16
- List open databases and group contents
17
-
- Resolve Zotero metadata for DEVONthink attachments via Zotero exports
18
-
- Locate DEVONthink records directly from Zotero citation keys or attachment metadata
17
+
- Resolve bibliography metadata for DEVONthink attachments via bibliography exports
18
+
- Locate DEVONthink records directly from citation keys or attachment metadata
19
19
- All tools are type-safe and validated with Zod schemas
20
20
21
21
## Tools
@@ -104,15 +104,15 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
104
104
- Input: primary record UUID, optional second record UUID, database name, and comparison type
105
105
- Returns: Either similar records (single mode) or detailed comparison analysis (two-record mode)
106
106
107
-
17.`get_zotero_metadata`
108
-
- Resolves Zotero metadata for a DEVONthink record or Finder path
107
+
17.`get_bib_metadata`
108
+
- Resolves bibliography metadata for a DEVONthink record or Finder path
109
109
- Input: Finder path, record UUID, DEVONthink ID + database, or DEVONthink location path (optional `zoteroJsonPath` / `zoteroBibPath` override export locations)
110
-
- Returns: The matched Zotero item with top-level `citationKey`, `zoteroId`, attachment list, and a short summary string for LLM prompts
110
+
- Returns: The matched bibliography item with top-level `citationKey`, `zoteroId`, attachment list, and a short summary string for LLM prompts
111
111
112
-
18.`find_records_by_citation_key`
113
-
- Resolves a Zotero citation key to its attachment metadata and matching DEVONthink records
114
-
- Input: `citationKey` along with optional overrides for Zotero JSON/BibTeX export paths
115
-
- Returns: Zotero metadata (JSON or BibTeX) plus any DEVONthink records whose Finder paths match the attachment entries
112
+
18.`get_records_by_citekey`
113
+
- Resolves a citation key to its attachment metadata and matching DEVONthink records
114
+
- Input: `citationKey` along with optional overrides for JSON/BibTeX export paths
115
+
- Returns: Bibliography metadata (JSON or BibTeX) plus any DEVONthink records whose Finder paths match the attachment entries
116
116
117
117
### Example: Search Tool
118
118
@@ -143,7 +143,7 @@ Add to your Claude configuration:
@@ -163,11 +163,11 @@ Add to your Claude configuration:
163
163
164
164
See [CLAUDE.md](./CLAUDE.md) for full documentation, tool development guidelines, and API reference.
165
165
166
-
## Zotero Metadata Lookup
166
+
## Bibliography Metadata Lookup
167
167
168
-
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.
168
+
Bibliography attachments stored in DEVONthink can be matched to exported bibliography metadata. The MCP server inspects both JSON and BibTeX exports and prefers JSON when both are present.
169
169
170
-
1. Export your Zotero library (or a subset) to `bibliography.json` and/or `bibliography.bib`.
170
+
1. Export your bibliography library (or a subset) to `bibliography.json` and/or `bibliography.bib`.
171
171
2. Point the server at the exports via environment variables before launching it (using Claude's MCP configuration or your shell):
172
172
173
173
```bash
@@ -178,7 +178,7 @@ Zotero attachments stored in DEVONthink can be matched to exported Zotero metada
178
178
- Supplying only one file is fine—the server detects whether you provided a `.json` or `.bib` path and uses it automatically.
179
179
- If no metadata file is configured, the tool returns an informative error so you can correct the setup.
180
180
181
-
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.
181
+
3. Call the `get_bib_metadata` tool with a Finder path or any supported DEVONthink identifier. The tool returns the matched bibliography 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.
0 commit comments