About DeepPane Focus Space
DeepPane Focus Space is the official stdio MCP server for creating focus spaces and reading user-authorized focus-history summaries. Account-scoped actions use separate authorization handoffs; raw focus events and media catalogs are not exposed.
Key features
- 01Create focus spaces
- 02Read focus-history summaries
- 03Request creation authorization tokens
- 04Request history-summary authorization tokens
Use cases
- 01Create a space for a focused work session
- 02Review an authorized focus-history summary
MCP support
This MCP server connects to clients over stdio and exposes tools to create focus spaces, read history summaries, and initiate authorization handoffs.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| quote | object | No | Quote request. Free uses catalog quotes; Pro handoff tokens may allow custom quote text. |
| quote.mode | enum | No | catalog | custom |
| quote.text | string | No | |
| quote.title | string | No | |
| quote.author | string | No | |
| quote.intent | string | No | |
| quote.customText | string | No | |
| timer | object | No | Bounded timer request. |
| timer.preset | string | No | |
| timer.presetId | string | No | |
| timer.breakMinutes | integer | No | |
| timer.breakSeconds | integer | No | |
| timer.focusMinutes | integer | No | |
| timer.focusSeconds | integer | No | |
| timer.durationMinutes | integer | No | |
| intent | enum | No | Supported work intent used for semantic scene and music selection.ambient_work | coding | creative_reset | deep_work | focus | inspiration | planning | reading | recovery | study | travel_reset | writing |
| locale | string | No | Optional DeepPane locale, for example en or zh-CN. |
| musicHints | object | No | Safe semantic hints for music selection, not raw track metadata. |
| musicHints.use | any | No | |
| musicHints.mood | any | No | |
| musicHints.sound | any | No | |
| musicHints.style | any | No | |
| musicHints.energyLevel | any | No | |
| musicHints.vocalProfile | any | No | |
| musicHints.distractionLevel | any | No | |
| sceneHints | object | No | Safe semantic hints for scene selection, not raw catalog filters. |
| sceneHints.mood | any | No | |
| sceneHints.sound | any | No | |
| sceneHints.motion | any | No | |
| sceneHints.timeOfDay | any | No | |
| sceneHints.brightness | any | No | |
| sceneHints.environment | any | No | |
| sceneHints.focusSafety | any | No | |
| sceneHints.visualDensity | any | No | |
| attribution | object | No | Optional safe caller attribution. Do not include secrets, account data, raw prompts, or personal history. |
| attribution.runId | string | No | |
| attribution.source | string | No | |
| attribution.agentRunId | string | No | |
| operationId | string | No | Stable operation id, combined with attribution.agentRunId when idempotencyKey is omitted. |
| handoffToken | string | No | Short-lived focus_space.create token copied from the DeepPane Dashboard Agent Access panel. |
| idempotencyKey | string | No | Stable opaque key for retry-safe creation. Reuse only for the same logical request. |
Details
From the project READMEDeepPane MCP Server
The official stdio MCP server for creating DeepPane focus spaces and reading user-authorized focus history summaries.
Requirements
- Node.js 20 or newer
- An MCP client that supports local stdio servers
Run
npm exec --yes --package=@deeppane/mcp-server -- deeppane-mcp
When npx is available, the shorter npx -y @deeppane/mcp-server command is equivalent.
Example MCP client configuration:
{
"mcpServers": {
"deeppane": {
"command": "npm",
"args": ["exec", "--yes", "--package=@deeppane/mcp-server", "--", "deeppane-mcp"]
}
}
}
On Windows, prefer the npm-native form when npx is not installed or an MCP client cannot resolve command shims.
Tools
deeppane.create_focus_space: create a retry-safe focus space using anonymous Free behavior or a user-authorized handoff token.deeppane.read_history_summary: read a sanitized focus-history summary with a user-authorized handoff token.deeppane.request_focus_space_create_token: open the DeepPane authorization handoff for focus-space creation.deeppane.request_history_summary_token: open the separate authorization handoff for history summaries.
The server does not expose the DeepPane media catalog, raw focus events, storage keys, signed media URLs, or user credentials.
Optional environment settings
DEEPPANE_MCP_TIMEOUT_MS: request timeout from 1000 to 60000 milliseconds. Default: 15000.
Normal public use requires no API key. Authorization for account-scoped tools is completed by the user in the DeepPane Dashboard and passed as a short-lived handoff token to the relevant tool call.
Development
npm install
npm test
npm run check:clean-install
Documentation: https://deeppane.com/mcp
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.