{"_id":"@daanvanhulsen/figjam-mcp-server","name":"@daanvanhulsen/figjam-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.1":{"name":"@daanvanhulsen/figjam-mcp-server","version":"1.0.1","description":"A Figjam MCP server tool, runnable via npx","type":"module","main":"dist/index.js","bin":{"figjam-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc-watch --onSuccess \"node dist/index.js\"","clean":"rm -rf dist","rebuild":"npm run clean && npm run build","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1"},"dependencies":{"@modelcontextprotocol/sdk":"^1.4.0","axios":"^1.8.4","chalk":"^5.4.1","dotenv":"^16.4.5","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.19","tsc-watch":"^6.0.4","ts-node":"^10.9.2","typescript":"^5.3.3"},"keywords":["figjam","mcp","figma","cli","tool"],"author":"","license":"MIT","repository":{"type":"git","url":""},"engines":{"node":">=18"},"_id":"@daanvanhulsen/figjam-mcp-server@1.0.1","gitHead":"d9b3d5ea6b09e2126c1cb9f0003ec77de75436d8","_nodeVersion":"20.9.0","_npmVersion":"10.1.0","dist":{"integrity":"sha512-TOmwvlY+miPP5sTnBzIPimEWk0rHufRphGex2b8wY9uMvFn7gUmVTH5a9272w5NWhAJ1ZCFi8jgtv4GUhZuAKA==","shasum":"482f3be28b7dd546a9a43347a23ca29e1e1b3f99","tarball":"https://registry.npmjs.org/@daanvanhulsen/figjam-mcp-server/-/figjam-mcp-server-1.0.1.tgz","fileCount":3,"unpackedSize":21234,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDOwjMLCPHzyCiCVBqLwE0YW3jbKBvw1Z7lhyl/mY0GGQIgATI94WDTxcxTgORlyAXk5zC31AM8vX9mmCXOZmRiaAc="}]},"_npmUser":{"name":"daanvanhulsen","email":"daan@minimum.studio"},"directories":{},"maintainers":[{"name":"daanvanhulsen","email":"daan@minimum.studio"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/figjam-mcp-server_1.0.1_1744750508483_0.5958556530158543"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-15T20:55:08.482Z","1.0.1":"2025-04-15T20:55:08.653Z","modified":"2025-04-15T20:55:09.296Z"},"maintainers":[{"name":"daanvanhulsen","email":"daan@minimum.studio"}],"description":"A Figjam MCP server tool, runnable via npx","keywords":["figjam","mcp","figma","cli","tool"],"repository":{"type":"git","url":""},"license":"MIT","readme":"# Figjam MCP\n\n### Give your coding agent access to your Figjam data.\nImplement collaborative whiteboarding features with AI assistance.\n\n## Overview\n\nThe Figjam MCP (Model Context Protocol) server enables AI-powered coding tools like Cursor to understand and interact with your Figjam whiteboard data. This allows for seamless integration of Figjam content into your development workflow, making it easier to implement collaborative features and maintain design consistency.\n\n## How it works\n\n1. Open your IDE's chat (e.g. agent mode in Cursor)\n2. Paste a link to a Figjam board or specific node\n3. Ask Cursor to perform actions with the Figjam content - e.g., implement features, analyze structure, or extract content\n4. The MCP server fetches relevant metadata from Figjam and provides it to your AI coding assistant\n\nThis MCP server is specifically designed to work with Cursor. It processes and simplifies Figjam API responses to provide only the most relevant information to the AI model, ensuring more accurate and focused assistance.\n\n## Features\n\n- **Content Extraction**: Get structured content from Figjam boards\n- **Hierarchy Analysis**: Understand the structure and relationships between elements\n- **Node-specific Access**: Target specific elements within a board\n- **Real-time Updates**: Stay in sync with Figjam board changes\n- **Type-safe Implementation**: Built with TypeScript for reliable development\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (v16 or higher)\n- A Figjam account\n- An IDE that supports MCP (e.g., Cursor)\n\n### Installation\n\n1. Clone the repository and install dependencies:\n```bash\ngit clone https://github.com/yourusername/figjam-mcp.git\ncd figjam-mcp\nnpm install\n# or\nyarn install\n```\n\n2. Build the project:\n```bash\nnpm run build\n# or\nyarn build\n```\n\n3. Configure your IDE's MCP settings by adding the following to your configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"Figjam-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/figjam-mcp/dist/index.js\"\n      ],\n      \"env\": {\n        \"FIGJAM_API_TOKEN\": \"your-figjam-api-token\"\n      }\n    }\n  }\n}\n```\n\n> **Note**: Replace `/path/to/figjam-mcp` with your actual installation path and `your-figjam-api-token` with your Figjam API token. You can get an API token from the Figjam developer portal.\n\n### Environment Variables\n\nThe MCP server requires the following environment variable:\n\n- `FIGJAM_API_TOKEN`: Your Figjam API access token\n\n### Windows Configuration\n\nFor Windows users, use the following configuration, adjusting the path format accordingly:\n\n```json\n{\n  \"mcpServers\": {\n    \"Figjam-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"C:\\\\Users\\\\YourUsername\\\\figjam-mcp\\\\dist\\\\index.js\"\n      ],\n      \"env\": {\n        \"FIGJAM_API_TOKEN\": \"your-figjam-api-token\"\n      }\n    }\n  }\n}\n```\n\n> **Note**: Make sure to use double backslashes `\\\\` in the path for Windows configurations.\n\n## Usage\n\nOnce configured, you can interact with your Figjam boards directly through your IDE's AI assistant. Here are some example commands:\n\n```\n\"Get content from this Figjam board: [URL]\"\n\"Show me the structure of this board\"\n\"Extract all sticky notes from this board\"\n\"Get specific node content with ID: [NODE-ID]\"\n```\n\n## Development\n\nTo contribute or modify the MCP server:\n\n1. Clone the repository\n2. Install dependencies:\n```bash\nnpm install\n# or\nyarn install\n```\n3. Build the project:\n```bash\nnpm run build\n# or\nyarn build\n```\n\n## API Reference\n\nThe MCP server provides several key endpoints for Figjam interaction:\n\n- `getFigjamContent`: Get content from a specific board or node\n- `getFigjamStructure`: Get the hierarchical structure of a board\n- `getFigjamNodes`: Get specific node types from a board\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Thanks to the Figjam team for their excellent API\n- Inspired by the Figma Context MCP project\n- Built with support from the AI coding tools community\n\n## Support\n\nFor support, please:\n- Open an issue in the GitHub repository\n- Join our community Discord\n- Check the documentation for common solutions\n\n---\n\nBuilt with ❤️ for the AI-assisted development community\n","readmeFilename":"README.md","_rev":"1-025c2eb6b95652cdb95e579859d44da6"}