Transkribus REST and Processing APIs — collections, HTR/OCR; default v1, optional v2 beta.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add transkribus --env TRANSKRIBUS_PASSWORD='<TRANSKRIBUS_PASSWORD>' --env TRANSKRIBUS_SESSION_ID='<TRANSKRIBUS_SESSION_ID>' --env TRANSKRIBUS_ACCESS_TOKEN='<TRANSKRIBUS_ACCESS_TOKEN>' -- npx -y @lazyants/transkribus-mcp-server~/.codex/config.toml
[mcp_servers.transkribus]
command = "npx"
args = ["-y", "@lazyants/transkribus-mcp-server"]
env = { TRANSKRIBUS_PASSWORD = "<TRANSKRIBUS_PASSWORD>", TRANSKRIBUS_SESSION_ID = "<TRANSKRIBUS_SESSION_ID>", TRANSKRIBUS_ACCESS_TOKEN = "<TRANSKRIBUS_ACCESS_TOKEN>" }
# codex mcp add transkribus --env TRANSKRIBUS_PASSWORD='<TRANSKRIBUS_PASSWORD>' --env TRANSKRIBUS_SESSION_ID='<TRANSKRIBUS_SESSION_ID>' --env TRANSKRIBUS_ACCESS_TOKEN='<TRANSKRIBUS_ACCESS_TOKEN>' -- npx -y @lazyants/transkribus-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"transkribus": {
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_PASSWORD": "<TRANSKRIBUS_PASSWORD>",
"TRANSKRIBUS_SESSION_ID": "<TRANSKRIBUS_SESSION_ID>",
"TRANSKRIBUS_ACCESS_TOKEN": "<TRANSKRIBUS_ACCESS_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"transkribus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_PASSWORD": "<TRANSKRIBUS_PASSWORD>",
"TRANSKRIBUS_SESSION_ID": "<TRANSKRIBUS_SESSION_ID>",
"TRANSKRIBUS_ACCESS_TOKEN": "<TRANSKRIBUS_ACCESS_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"transkribus": {
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_PASSWORD": "<TRANSKRIBUS_PASSWORD>",
"TRANSKRIBUS_SESSION_ID": "<TRANSKRIBUS_SESSION_ID>",
"TRANSKRIBUS_ACCESS_TOKEN": "<TRANSKRIBUS_ACCESS_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"transkribus": {
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_PASSWORD": "<TRANSKRIBUS_PASSWORD>",
"TRANSKRIBUS_SESSION_ID": "<TRANSKRIBUS_SESSION_ID>",
"TRANSKRIBUS_ACCESS_TOKEN": "<TRANSKRIBUS_ACCESS_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"transkribus": {
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_PASSWORD": "<TRANSKRIBUS_PASSWORD>",
"TRANSKRIBUS_SESSION_ID": "<TRANSKRIBUS_SESSION_ID>",
"TRANSKRIBUS_ACCESS_TOKEN": "<TRANSKRIBUS_ACCESS_TOKEN>"
}
}
}
}Environment variables
TRANSKRIBUS_PASSWORDTRANSKRIBUS_SESSION_IDTRANSKRIBUS_ACCESS_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.