Zotero integration with hybrid search, PDF passages with page locators, CSL bibliographies, adding by DOI and safe writes.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add zoteus --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- npx -y @oscardvs/zoteus~/.codex/config.toml
[mcp_servers.zoteus]
command = "npx"
args = ["-y", "@oscardvs/zoteus"]
env = { ZOTERO_API_KEY = "<ZOTERO_API_KEY>" }
# codex mcp add zoteus --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- npx -y @oscardvs/zoteus~/.cursor/mcp.json
{
"mcpServers": {
"zoteus": {
"command": "npx",
"args": [
"-y",
"@oscardvs/zoteus"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"zoteus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oscardvs/zoteus"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"zoteus": {
"command": "npx",
"args": [
"-y",
"@oscardvs/zoteus"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"zoteus": {
"command": "npx",
"args": [
"-y",
"@oscardvs/zoteus"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"zoteus": {
"command": "npx",
"args": [
"-y",
"@oscardvs/zoteus"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http zoteus https://mcp.zoteus.com/mcp~/.codex/config.toml
[mcp_servers.zoteus]
url = "https://mcp.zoteus.com/mcp"
# codex mcp add zoteus --url https://mcp.zoteus.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"zoteus": {
"url": "https://mcp.zoteus.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"zoteus": {
"type": "http",
"url": "https://mcp.zoteus.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"zoteus": {
"httpUrl": "https://mcp.zoteus.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"zoteus": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.zoteus.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"zoteus": {
"url": "https://mcp.zoteus.com/mcp"
}
}
}Environment variables
ZOTERO_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.