Searches and manages a Zotero library, adds items by DOI, finds open-access PDFs and inserts live citations into Word documents.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add zotero --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env ZOTERO_USER_ID='<ZOTERO_USER_ID>' -- npx -y @xevos117/mcp-zotero~/.codex/config.toml
[mcp_servers.zotero]
command = "npx"
args = ["-y", "@xevos117/mcp-zotero"]
env = { ZOTERO_API_KEY = "<ZOTERO_API_KEY>", ZOTERO_USER_ID = "<ZOTERO_USER_ID>" }
# codex mcp add zotero --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env ZOTERO_USER_ID='<ZOTERO_USER_ID>' -- npx -y @xevos117/mcp-zotero~/.cursor/mcp.json
{
"mcpServers": {
"zotero": {
"command": "npx",
"args": [
"-y",
"@xevos117/mcp-zotero"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"ZOTERO_USER_ID": "<ZOTERO_USER_ID>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"zotero": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xevos117/mcp-zotero"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"ZOTERO_USER_ID": "<ZOTERO_USER_ID>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"zotero": {
"command": "npx",
"args": [
"-y",
"@xevos117/mcp-zotero"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"ZOTERO_USER_ID": "<ZOTERO_USER_ID>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"zotero": {
"command": "npx",
"args": [
"-y",
"@xevos117/mcp-zotero"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"ZOTERO_USER_ID": "<ZOTERO_USER_ID>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"zotero": {
"command": "npx",
"args": [
"-y",
"@xevos117/mcp-zotero"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
"ZOTERO_USER_ID": "<ZOTERO_USER_ID>"
}
}
}
}Environment variables
ZOTERO_API_KEYZOTERO_USER_ID
Replace the placeholders with your own credentials and keep them out of version control.