Token Optimizer MCP
Token Optimizer MCP is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Context-window optimization: caching, compression & smart file tools that cut tokens 60-90%. It has 585 GitHub stars, is released under the MIT license and runs locally with npx -y @ooples/token-optimizer-mcp.
github.com/ooples/token-optimizer-mcp (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install Token Optimizer MCP
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"token-optimizer-mcp": {
"command": "npx",
"args": [
"-y",
"@ooples/token-optimizer-mcp"
],
"env": {
"TOKEN_OPTIMIZER_CACHE_DIR": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env TOKEN_OPTIMIZER_CACHE_DIR=your-value --transport stdio token-optimizer-mcp -- npx -y @ooples/token-optimizer-mcpCursor
{
"mcpServers": {
"token-optimizer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ooples/token-optimizer-mcp"
],
"env": {
"TOKEN_OPTIMIZER_CACHE_DIR": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "token_optimizer_cache_dir",
"description": "TOKEN_OPTIMIZER_CACHE_DIR",
"password": true
}
],
"servers": {
"token-optimizer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ooples/token-optimizer-mcp"
],
"env": {
"TOKEN_OPTIMIZER_CACHE_DIR": "${input:token_optimizer_cache_dir}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
TOKEN_OPTIMIZER_CACHE_DIRsecret | No | Directory path for cache storage (optional, defaults to ~/.token-optimizer-cache) |
About Token Optimizer MCP
Cut what your AI coding agent costs without cutting what it gets done. Hooks, a proxy, and an MCP server for Claude Code, Codex, Copilot, Gemini and 12 more clients.
- ai
- caching
- claude
- compression
- llm
- mcp
- mcp-server
- token-optimization
- gemini-cli-extension
- ai-agents
Similar MCP servers
More developer tools MCP servers
Hex Graph
levnikolaevich/claude-code-skills
Deterministic layered code graph MCP server with framework overlays and SCIP interop.
Active · last commit Nov 11, 2026
Developer toolsShellMingyu
Brhiza/mingyu
八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式玄学算命占卜工具包,输出结构化提示词与数据。提供公开 API、MCP Server 与 skill。.
Active · last commit Nov 14, 2026
Developer toolsTypeScriptProxmoxMCP-Plus
RekklesNA/ProxmoxMCP-Plus
Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.
Active · last commit Nov 15, 2026
Developer toolsPythonhumanizer-ru
ilyautov/humanizer-ru
Следы нейросети в русском тексте: балл чистоты 0-100, запреты и маркеры с позициями, факт-замок.
Active · last commit Nov 11, 2026
Developer toolsPythonAgent Safe Pipeline
decionis/agent-safe-pipeline
Authorize consequential AI agent actions before execution.
Active · last commit Nov 16, 2026
OfficialDeveloper toolsTypeScriptPartCAD
partcad/partcad
Inspect, render, test and export the parts and assemblies of PartCAD hardware packages.
Active · last commit Nov 16, 2026
Developer toolsPython
How do I install the Token Optimizer MCP MCP server?
Add the command npx -y @ooples/token-optimizer-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Token Optimizer MCP free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is Token Optimizer MCP actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v7.11.0, published Nov 14, 2026. appsgit only lists MCP servers with a commit in the last six months.